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

package/dist/workflows/run/wait-engine.d.ts

@@ -0,0 +1,1210 @@
+import type { Wait, WaitErrorCode, AskErrorCode, WorkerWaitEntry } from '../../contract/index.js';
+import type { ActiveRun } from '../active-run.ts';
+import type { RunModuleContext } from './types.ts';
+import type { RunRecord } from '../../runs/store.ts';
+import type { CiWatcherSupervisor } from '../../ci-wait/supervisor.ts';
+import { ProcessWaitSupervisor } from '../../process-wait/supervisor.ts';
+import type { ExitFileRoots } from '../../process-wait/exit-file.ts';
+import { type WaitResult } from '../waits.ts';
+import { type RegistrationIdentity } from './wait-registration.ts';
+export declare function warnRegistrationRefused(code: WaitErrorCode | AskErrorCode): void;
+/** What the engine asks the rest of the run manager (ADR 0053): wake admission, the run line,
+ *  the family reconcile, human waits and the subagent session. */
+interface WaitEngineHost {
+    active(id: string): ActiveRun | undefined;
+    canProceedWithRun(id: string, run: RunRecord | undefined): run is RunRecord;
+    ciSupervisor(): Pick<CiWatcherSupervisor, 'resolve' | 'watch' | 'close'>;
+    reconcileWorkerWaits(family?: string): void;
+    noticeParkedWorkers(id: string): void;
+    withdrawCezarHumanWaits(id: string): void;
+    /** The session that holds a subagent wait's children is live (hearsay-tools/cezarion#2431). */
+    subagentSessionLive(id: string): boolean;
+    /** Resolve a subagent wait whose session is gone `interrupted`, ending its running children in the transcript (hearsay-tools/cezarion#2431). */
+    interruptSubagentWait(id: string, waitId: string): void;
+    countAutomaticWakes(id: string): number;
+    /** Cancel these waits at the wake cap, then repark the session or wait on the user without one. */
+    wakeCapReached(id: string, waits: readonly Wait[], state: ActiveRun | undefined): void;
+    queueWaitWake(id: string): void;
+    retryWaitAdmission(id: string): void;
+    isParked(id: string): boolean;
+    parkOnWaits(id: string, state: ActiveRun): void;
+    abortRegistrations(id: string): void;
+    /** Forget the run's wake retries, wake delivery, queued wake and admission, in that order. */
+    forgetWakes(id: string): void;
+}
+/** The steps a registration path chooses; the row decides the arm, the park guard and the entry returned. */
+interface OpenOptions {
+    /** Withdraw Cezar's human waits after the compare, before the commit. */
+    withdraw: boolean;
+    receipt?: RegistrationIdentity | undefined;
+    onCommitFailure?: CommitFailure;
+    /** Park when the run is at its turn boundary or parked. */
+    park: boolean;
+    /** Present: the caller already holds the result (undefined takes the row's default), so the
+     *  wait arms nothing and resolves with it at once. */
+    result?: WaitResult | undefined;
+}
+/** Absent: the commit error escapes as it is. `persistence`: the tool's coded `capacity` or
+ *  `persistence` error. `log`: warn and refuse. `capacity`: a full list throws the path's own error. */
+type CommitFailure = 'persistence' | {
+    log: string;
+} | {
+    capacity: () => Error;
+};
+export type OpenResult<W extends Wait> = {
+    status: 'opened';
+    wait: W;
+} | {
+    status: 'refused';
+    wait?: undefined;
+};
+interface CancelWaitsOptions {
+    onCommitFailure?: 'throw' | 'skip';
+    superseded?: true;
+    log?: string;
+}
+/** Executes the wait-kind rows behind the run facade: open, arm, resolve, re-arm, cancel and forget. */
+export declare class WaitEngine {
+    private readonly context;
+    private readonly host;
+    private readonly maxAutoContinues;
+    private readonly processSupervisor;
+    /** One CI watch per open CI wait, keyed by wait id. */
+    private readonly ciWatches;
+    /** A resolution whose checkpoint failed, retried by wait id. */
+    private readonly ciRetries;
+    /** Process waits' watches (hearsay-tools/cezarion#1446), by wait id. */
+    private readonly processWatches;
+    private readonly workerResolveRetries;
+    /** One timer per open timer wait, keyed by wait id. */
+    private readonly waitTimers;
+    /** The watch adapter each row names. */
+    private readonly watches;
+    constructor(context: RunModuleContext, host: WaitEngineHost, maxAutoContinues: number, processSupervisor?: Pick<ProcessWaitSupervisor, 'watch' | 'close'>);
+    /** Whether the run's open-wait list has room. Each caller keeps its own refusal shape. */
+    hasRoom(run: Pick<RunRecord, 'waits'>): boolean;
+    /** Commit, arm and (at a boundary) park on a newly registered wait. A wait opened with the
+     *  result its caller already holds arms nothing and resolves with it after the park. */
+    open<W extends Wait>(runId: string, state: ActiveRun | undefined, wait: W, options: OpenOptions): OpenResult<W>;
+    private armOpened;
+    /**
+     * Commit a changed open wait, then arm it. A moved deadline disarms the old one first; an
+     * unchanged one keeps what is armed, including a checkpoint retry. False when the commit failed
+     * under a `log` policy: the saved wait and what is armed stay as they were.
+     */
+    refresh(runId: string, previous: Wait, next: Wait, onCommitFailure?: {
+        log: string;
+    }): boolean;
+    private commitOpened;
+    /** A worker wait the family reconcile already resolved is no longer listed, and parks nothing. */
+    private park;
+    /** The entry as recorded now: the store keeps the entry it was given, and only its phase can
+     *  have moved since. A worker wait with a deadline may already be settled by the reconcile. */
+    private openedEntry;
+    /** Where a process wait's exit file may sit: the run's worktree (the checkout for a run without
+     *  one) and, unless turned off, the Cezar temp directory its agent gets as `TMPDIR`. */
+    exitFileRoots(runId: string, run?: {
+        archiveWhenDone?: boolean | undefined;
+        autoMergePr?: boolean | undefined;
+        allowWorkers?: boolean | undefined;
+        allowMessaging?: boolean | undefined;
+        id: string;
+        title: string;
+        titleSummary?: string | undefined;
+        diffStat?: {
+            adds: number;
+            dels: number;
+            files: number;
+            repointed?: boolean | undefined;
+        } | undefined;
+        workflow: string;
+        task: string;
+        queuedMessages?: {
+            id: string;
+            text: string;
+            images?: string[] | undefined;
+            createdAt: string;
+        }[] | undefined;
+        continuationMessage?: {
+            id: string;
+            text: string;
+            images?: string[] | undefined;
+            createdAt: string;
+            origin?: "human" | "lifecycle" | undefined;
+            agentInputId?: string | undefined;
+            resumeContext?: {
+                failure?: {
+                    stepId?: string | undefined;
+                    error: string;
+                } | undefined;
+                restarted?: true | undefined;
+            } | undefined;
+        } | undefined;
+        workflowResumeStepId?: string | undefined;
+        invalidAsk?: boolean | undefined;
+        agentInputs?: {
+            conversation?: {
+                senderRunId: string;
+                recipientRunId: string;
+                kind: "follow-up" | "progress" | "reply" | "request";
+                requestId?: string | undefined;
+                relationship?: "family" | "peer" | undefined;
+            } | undefined;
+            id: string;
+            source: "agent" | "lifecycle";
+            parentRunId: string;
+            text: string;
+            createdAt: string;
+            deliveredAt?: string | undefined;
+            consumedAt?: string | undefined;
+            awaitingRead?: true | undefined;
+            inboxClaim?: {
+                receiptId: string;
+                generation: string;
+                expiresAt: string;
+                acknowledgedAt?: string | undefined;
+                memberIds?: string[] | undefined;
+            } | undefined;
+            purpose?: "completion-refusal" | "undelivered-question" | undefined;
+            requestHash?: string | undefined;
+            deadline?: string | undefined;
+        }[] | undefined;
+        waits?: ({
+            prUrl: string;
+            repository: string;
+            prNumber: number;
+            headSha: string;
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "pr";
+            deadline: string;
+            generation: string;
+            timeoutSeconds: number;
+            until: "checks" | "merge" | "merge_or_blocked";
+            wakeOnConflict: boolean;
+            result?: {
+                outcome: "blocked" | "cancelled" | "closed" | "conflicting" | "deadline" | "error" | "failed" | "head_changed" | "merged" | "no_checks" | "passed" | "skipped";
+                headSha: string;
+                observedHeadSha?: string | undefined;
+                mergeable?: "CONFLICTING" | "MERGEABLE" | "UNKNOWN" | undefined;
+                mergeStateStatus?: string | undefined;
+                mergedAt?: string | undefined;
+                mergeCommitSha?: string | undefined;
+                mergeBlock?: {
+                    reason: "conflict" | "no_pending_merge";
+                    isInMergeQueue: boolean;
+                    autoMergeEnabled: boolean;
+                    event?: {
+                        kind: "auto_merge_disabled" | "queue_removal";
+                        createdAt: string;
+                        reason?: string | undefined;
+                        reasonCode?: string | undefined;
+                    } | undefined;
+                } | undefined;
+                observedAt: string;
+                checks: {
+                    name: string;
+                    state: string;
+                    link: string;
+                }[];
+                totalChecks: number;
+                truncated: boolean;
+                diagnostic?: string | undefined;
+            } | undefined;
+        } | {
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "timer";
+            deadline: string;
+            seconds: number;
+            note?: string | undefined;
+        } | {
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "human";
+            questions?: {
+                id?: string | undefined;
+                header: string;
+                question: string;
+                options?: {
+                    label: string;
+                    description?: string | undefined;
+                }[] | undefined;
+                multiSelect?: boolean | undefined;
+            }[] | undefined;
+            context?: string | undefined;
+            askSeq?: number | undefined;
+        } | {
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "worker";
+            deadline?: string | undefined;
+            timeoutSeconds?: number | undefined;
+            mode?: "all" | "any" | "one" | undefined;
+            workerIds?: string[] | undefined;
+            revisions?: {
+                workerId: string;
+                revision: number;
+            }[] | undefined;
+            outcomes?: {
+                workerId: string;
+                status: "cancelled" | "done" | "failed" | "review";
+                observedAt: string;
+                summary?: string | undefined;
+                revision?: number | undefined;
+            }[] | undefined;
+            requestIds?: string[] | undefined;
+            requestOutcomes?: {
+                requestId: string;
+                status: "cancelled" | "completed-without-reply" | "deleted" | "destroyed" | "failed" | "human-fallback" | "replied" | "replied-late" | "sender-closed" | "timed-out";
+                observedAt: string;
+                replyId?: string | undefined;
+            }[] | undefined;
+            result?: {
+                reason: "outcome" | "timeout";
+            } | undefined;
+            wakeInputId?: string | undefined;
+        } | {
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "process";
+            deadline: string;
+            timeoutSeconds: number;
+            pid: number;
+            startToken?: string | undefined;
+            exitFile?: string | undefined;
+            note?: string | undefined;
+            result?: {
+                outcome: "deadline" | "error" | "exit_file" | "exited";
+                observedAt: string;
+                exitCode?: number | undefined;
+                exitFileNote?: "not-an-exit-code" | undefined;
+                diagnostic?: string | undefined;
+            } | undefined;
+        } | {
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "peer";
+            deadline: string;
+            timeoutSeconds: number;
+            peerIds: string[];
+            result?: {
+                reason: "message";
+                peerRunId: string;
+                messageId: string;
+            } | {
+                reason: "settled";
+                peerRunId: string;
+            } | {
+                reason: "timeout";
+            } | undefined;
+        } | {
+            id: string;
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "subagent";
+            source: "cezar";
+            via: "native-subagents";
+            deadline: string;
+            children: {
+                id: string;
+                status: "cancelled" | "completed" | "failed" | "running";
+            }[];
+            result?: {
+                reason: "interrupted" | "settled" | "superseded" | "timeout";
+            } | undefined;
+        })[] | undefined;
+        waitRegistrations?: {
+            operationId: string;
+            requestHash: string;
+            wait: {
+                prUrl: string;
+                repository: string;
+                prNumber: number;
+                headSha: string;
+                id: string;
+                source: "agent" | "cezar";
+                via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+                registeredAt: string;
+                phase: "cancelled" | "delivered" | "open" | "resolved";
+                resolvedAt?: string | undefined;
+                deliveredAt?: string | undefined;
+                cancelledAt?: string | undefined;
+                turnId: string;
+                kind: "pr";
+                deadline: string;
+                generation: string;
+                timeoutSeconds: number;
+                until: "checks" | "merge" | "merge_or_blocked";
+                wakeOnConflict: boolean;
+                result?: {
+                    outcome: "blocked" | "cancelled" | "closed" | "conflicting" | "deadline" | "error" | "failed" | "head_changed" | "merged" | "no_checks" | "passed" | "skipped";
+                    headSha: string;
+                    observedHeadSha?: string | undefined;
+                    mergeable?: "CONFLICTING" | "MERGEABLE" | "UNKNOWN" | undefined;
+                    mergeStateStatus?: string | undefined;
+                    mergedAt?: string | undefined;
+                    mergeCommitSha?: string | undefined;
+                    mergeBlock?: {
+                        reason: "conflict" | "no_pending_merge";
+                        isInMergeQueue: boolean;
+                        autoMergeEnabled: boolean;
+                        event?: {
+                            kind: "auto_merge_disabled" | "queue_removal";
+                            createdAt: string;
+                            reason?: string | undefined;
+                            reasonCode?: string | undefined;
+                        } | undefined;
+                    } | undefined;
+                    observedAt: string;
+                    checks: {
+                        name: string;
+                        state: string;
+                        link: string;
+                    }[];
+                    totalChecks: number;
+                    truncated: boolean;
+                    diagnostic?: string | undefined;
+                } | undefined;
+            } | {
+                id: string;
+                source: "agent" | "cezar";
+                via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+                registeredAt: string;
+                phase: "cancelled" | "delivered" | "open" | "resolved";
+                resolvedAt?: string | undefined;
+                deliveredAt?: string | undefined;
+                cancelledAt?: string | undefined;
+                turnId: string;
+                kind: "timer";
+                deadline: string;
+                seconds: number;
+                note?: string | undefined;
+            } | {
+                id: string;
+                source: "agent" | "cezar";
+                via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+                registeredAt: string;
+                phase: "cancelled" | "delivered" | "open" | "resolved";
+                resolvedAt?: string | undefined;
+                deliveredAt?: string | undefined;
+                cancelledAt?: string | undefined;
+                turnId: string;
+                kind: "human";
+                questions?: {
+                    id?: string | undefined;
+                    header: string;
+                    question: string;
+                    options?: {
+                        label: string;
+                        description?: string | undefined;
+                    }[] | undefined;
+                    multiSelect?: boolean | undefined;
+                }[] | undefined;
+                context?: string | undefined;
+                askSeq?: number | undefined;
+            } | {
+                id: string;
+                source: "agent" | "cezar";
+                via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+                registeredAt: string;
+                phase: "cancelled" | "delivered" | "open" | "resolved";
+                resolvedAt?: string | undefined;
+                deliveredAt?: string | undefined;
+                cancelledAt?: string | undefined;
+                turnId: string;
+                kind: "worker";
+                deadline?: string | undefined;
+                timeoutSeconds?: number | undefined;
+                mode?: "all" | "any" | "one" | undefined;
+                workerIds?: string[] | undefined;
+                revisions?: {
+                    workerId: string;
+                    revision: number;
+                }[] | undefined;
+                outcomes?: {
+                    workerId: string;
+                    status: "cancelled" | "done" | "failed" | "review";
+                    observedAt: string;
+                    summary?: string | undefined;
+                    revision?: number | undefined;
+                }[] | undefined;
+                requestIds?: string[] | undefined;
+                requestOutcomes?: {
+                    requestId: string;
+                    status: "cancelled" | "completed-without-reply" | "deleted" | "destroyed" | "failed" | "human-fallback" | "replied" | "replied-late" | "sender-closed" | "timed-out";
+                    observedAt: string;
+                    replyId?: string | undefined;
+                }[] | undefined;
+                result?: {
+                    reason: "outcome" | "timeout";
+                } | undefined;
+                wakeInputId?: string | undefined;
+            } | {
+                id: string;
+                source: "agent" | "cezar";
+                via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+                registeredAt: string;
+                phase: "cancelled" | "delivered" | "open" | "resolved";
+                resolvedAt?: string | undefined;
+                deliveredAt?: string | undefined;
+                cancelledAt?: string | undefined;
+                turnId: string;
+                kind: "process";
+                deadline: string;
+                timeoutSeconds: number;
+                pid: number;
+                startToken?: string | undefined;
+                exitFile?: string | undefined;
+                note?: string | undefined;
+                result?: {
+                    outcome: "deadline" | "error" | "exit_file" | "exited";
+                    observedAt: string;
+                    exitCode?: number | undefined;
+                    exitFileNote?: "not-an-exit-code" | undefined;
+                    diagnostic?: string | undefined;
+                } | undefined;
+            } | {
+                id: string;
+                source: "agent" | "cezar";
+                via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+                registeredAt: string;
+                phase: "cancelled" | "delivered" | "open" | "resolved";
+                resolvedAt?: string | undefined;
+                deliveredAt?: string | undefined;
+                cancelledAt?: string | undefined;
+                turnId: string;
+                kind: "peer";
+                deadline: string;
+                timeoutSeconds: number;
+                peerIds: string[];
+                result?: {
+                    reason: "message";
+                    peerRunId: string;
+                    messageId: string;
+                } | {
+                    reason: "settled";
+                    peerRunId: string;
+                } | {
+                    reason: "timeout";
+                } | undefined;
+            } | {
+                id: string;
+                registeredAt: string;
+                phase: "cancelled" | "delivered" | "open" | "resolved";
+                resolvedAt?: string | undefined;
+                deliveredAt?: string | undefined;
+                cancelledAt?: string | undefined;
+                turnId: string;
+                kind: "subagent";
+                source: "cezar";
+                via: "native-subagents";
+                deadline: string;
+                children: {
+                    id: string;
+                    status: "cancelled" | "completed" | "failed" | "running";
+                }[];
+                result?: {
+                    reason: "interrupted" | "settled" | "superseded" | "timeout";
+                } | undefined;
+            };
+            deduplicated: boolean;
+        }[] | undefined;
+        lastWaits?: ({
+            prUrl: string;
+            repository: string;
+            prNumber: number;
+            headSha: string;
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "pr";
+            deadline: string;
+            generation: string;
+            timeoutSeconds: number;
+            until: "checks" | "merge" | "merge_or_blocked";
+            wakeOnConflict: boolean;
+            result?: {
+                outcome: "blocked" | "cancelled" | "closed" | "conflicting" | "deadline" | "error" | "failed" | "head_changed" | "merged" | "no_checks" | "passed" | "skipped";
+                headSha: string;
+                observedHeadSha?: string | undefined;
+                mergeable?: "CONFLICTING" | "MERGEABLE" | "UNKNOWN" | undefined;
+                mergeStateStatus?: string | undefined;
+                mergedAt?: string | undefined;
+                mergeCommitSha?: string | undefined;
+                mergeBlock?: {
+                    reason: "conflict" | "no_pending_merge";
+                    isInMergeQueue: boolean;
+                    autoMergeEnabled: boolean;
+                    event?: {
+                        kind: "auto_merge_disabled" | "queue_removal";
+                        createdAt: string;
+                        reason?: string | undefined;
+                        reasonCode?: string | undefined;
+                    } | undefined;
+                } | undefined;
+                observedAt: string;
+                checks: {
+                    name: string;
+                    state: string;
+                    link: string;
+                }[];
+                totalChecks: number;
+                truncated: boolean;
+                diagnostic?: string | undefined;
+            } | undefined;
+        } | {
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "timer";
+            deadline: string;
+            seconds: number;
+            note?: string | undefined;
+        } | {
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "human";
+            questions?: {
+                id?: string | undefined;
+                header: string;
+                question: string;
+                options?: {
+                    label: string;
+                    description?: string | undefined;
+                }[] | undefined;
+                multiSelect?: boolean | undefined;
+            }[] | undefined;
+            context?: string | undefined;
+            askSeq?: number | undefined;
+        } | {
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "worker";
+            deadline?: string | undefined;
+            timeoutSeconds?: number | undefined;
+            mode?: "all" | "any" | "one" | undefined;
+            workerIds?: string[] | undefined;
+            revisions?: {
+                workerId: string;
+                revision: number;
+            }[] | undefined;
+            outcomes?: {
+                workerId: string;
+                status: "cancelled" | "done" | "failed" | "review";
+                observedAt: string;
+                summary?: string | undefined;
+                revision?: number | undefined;
+            }[] | undefined;
+            requestIds?: string[] | undefined;
+            requestOutcomes?: {
+                requestId: string;
+                status: "cancelled" | "completed-without-reply" | "deleted" | "destroyed" | "failed" | "human-fallback" | "replied" | "replied-late" | "sender-closed" | "timed-out";
+                observedAt: string;
+                replyId?: string | undefined;
+            }[] | undefined;
+            result?: {
+                reason: "outcome" | "timeout";
+            } | undefined;
+            wakeInputId?: string | undefined;
+        } | {
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "process";
+            deadline: string;
+            timeoutSeconds: number;
+            pid: number;
+            startToken?: string | undefined;
+            exitFile?: string | undefined;
+            note?: string | undefined;
+            result?: {
+                outcome: "deadline" | "error" | "exit_file" | "exited";
+                observedAt: string;
+                exitCode?: number | undefined;
+                exitFileNote?: "not-an-exit-code" | undefined;
+                diagnostic?: string | undefined;
+            } | undefined;
+        } | {
+            id: string;
+            source: "agent" | "cezar";
+            via: "ask-line" | "budget" | "cez-message-wait" | "cez-worker-wait" | "cezar_ask" | "cezar_wait" | "cezar_wait_for_ci" | "completion" | "monitoring-line" | "native-ask" | "native-subagents" | "no-wait" | "schedule-wakeup";
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "peer";
+            deadline: string;
+            timeoutSeconds: number;
+            peerIds: string[];
+            result?: {
+                reason: "message";
+                peerRunId: string;
+                messageId: string;
+            } | {
+                reason: "settled";
+                peerRunId: string;
+            } | {
+                reason: "timeout";
+            } | undefined;
+        } | {
+            id: string;
+            registeredAt: string;
+            phase: "cancelled" | "delivered" | "open" | "resolved";
+            resolvedAt?: string | undefined;
+            deliveredAt?: string | undefined;
+            cancelledAt?: string | undefined;
+            turnId: string;
+            kind: "subagent";
+            source: "cezar";
+            via: "native-subagents";
+            deadline: string;
+            children: {
+                id: string;
+                status: "cancelled" | "completed" | "failed" | "running";
+            }[];
+            result?: {
+                reason: "interrupted" | "settled" | "superseded" | "timeout";
+            } | undefined;
+        })[] | undefined;
+        previewServers?: {
+            port: number;
+            command: string;
+            cwd?: string | undefined;
+            label: string;
+            path?: string | undefined;
+            registeredAt: string;
+            answeredAtRegistration: boolean;
+        }[] | undefined;
+        taskImages?: string[] | undefined;
+        model?: string | undefined;
+        effort?: string | undefined;
+        modelIdentity?: string | undefined;
+        agentProfile?: string | undefined;
+        systemPrompt?: string | undefined;
+        generateFollowups?: boolean | undefined;
+        autonomous?: boolean | undefined;
+        completionAction?: {
+            id: string;
+            phase: "blocked" | "complete" | "pending";
+            message?: string | undefined;
+        } | undefined;
+        archiveBlocker?: {
+            message: string;
+            runId?: string | undefined;
+            pullRequestUrl?: string | undefined;
+        } | undefined;
+        status: "cancelled" | "done" | "failed" | "queued" | "review" | "running" | "waiting";
+        createdAt: string;
+        startedAt?: string | undefined;
+        finishedAt?: string | undefined;
+        tokensUsed: number;
+        inputTokens?: number | undefined;
+        outputTokens?: number | undefined;
+        costUsd?: number | undefined;
+        pullRequestUrl?: string | undefined;
+        referencedPullRequestUrl?: string | undefined;
+        prNumber?: number | undefined;
+        issueNumber?: number | undefined;
+        referencedIssueNumberSeeded?: boolean | undefined;
+        titleOrigin?: "auto" | "marker" | "user" | undefined;
+        markerRefs?: {
+            pr?: number | undefined;
+            issue?: number | undefined;
+        } | undefined;
+        referencedPrCandidates?: string[] | undefined;
+        referencedIssueUrl?: string | undefined;
+        referencedIssueCandidates?: string[] | undefined;
+        worktree?: false | undefined;
+        worktreePath?: string | undefined;
+        branch?: string | undefined;
+        baseBranch?: string | undefined;
+        worktreeReclaimedAt?: string | undefined;
+        groupId?: string | undefined;
+        variant?: string | undefined;
+        clientRequestId?: string | undefined;
+        clientRequestHash?: string | undefined;
+        peakRssBytes?: number | undefined;
+        peakProcCount?: number | undefined;
+        archivedAt?: string | undefined;
+        autoArchive?: {
+            reason: "pull-requests-merged";
+            archivedAt: string;
+            fingerprint: string;
+            pullRequests: {
+                owner: string;
+                repo: string;
+                number: number;
+                mergedAt: string;
+            }[];
+        } | undefined;
+        manualUnarchivedAt?: string | undefined;
+        pinned?: boolean | undefined;
+        pinnedAt?: string | undefined;
+        seenAt?: string | undefined;
+        currentStepId?: string | undefined;
+        error?: string | undefined;
+        delegation?: {
+            role: "root";
+            conversation?: {
+                messages: {
+                    senderRunId: string;
+                    recipientRunId: string;
+                    kind: "follow-up" | "progress" | "reply" | "request";
+                    requestId?: string | undefined;
+                    relationship?: "family" | "peer" | undefined;
+                    id: string;
+                    text: string;
+                    createdAt: string;
+                    deadline?: string | undefined;
+                    requestHash: string;
+                    state: "accepted" | "continuation-required" | "destroyed" | "late";
+                    resumed?: true | undefined;
+                    instruction?: string | undefined;
+                    question?: {
+                        context?: string | undefined;
+                        questions: {
+                            id?: string | undefined;
+                            header: string;
+                            question: string;
+                            options?: {
+                                label: string;
+                                description?: string | undefined;
+                            }[] | undefined;
+                            multiSelect?: boolean | undefined;
+                        }[];
+                    } | undefined;
+                }[];
+                outcomes: {
+                    requestId: string;
+                    status: "cancelled" | "completed-without-reply" | "deleted" | "destroyed" | "failed" | "human-fallback" | "replied" | "replied-late" | "sender-closed" | "timed-out";
+                    observedAt: string;
+                    replyId?: string | undefined;
+                }[];
+            } | undefined;
+            permissions: ("destroy" | "diff" | "inspect" | "spawn" | "steer" | "stop" | "wait")[];
+            receipts: {
+                requestId: string;
+                workerId: string;
+                requestHash: string;
+                deletion?: {
+                    phase: "complete" | "pending";
+                    revision: number;
+                    resourceId: string;
+                    generation: string;
+                } | undefined;
+            }[];
+            wait?: {
+                id: string;
+                workerIds: string[];
+                requestIds?: string[] | undefined;
+                requestOutcomes?: {
+                    requestId: string;
+                    status: "cancelled" | "completed-without-reply" | "deleted" | "destroyed" | "failed" | "human-fallback" | "replied" | "replied-late" | "sender-closed" | "timed-out";
+                    observedAt: string;
+                    replyId?: string | undefined;
+                }[] | undefined;
+                deadline: string;
+                mode?: "all" | "any" | "one" | undefined;
+                revisions?: {
+                    workerId: string;
+                    revision: number;
+                }[] | undefined;
+                reason?: "cancelled" | "message" | "outcome" | "timeout" | undefined;
+                phase: "parked" | "registered" | "wake-pending";
+                outcomes: {
+                    workerId: string;
+                    status: "cancelled" | "done" | "failed" | "review";
+                    observedAt: string;
+                    summary?: string | undefined;
+                    revision?: number | undefined;
+                }[];
+                wakeId?: string | undefined;
+            } | undefined;
+            lastWait?: {
+                id: string;
+                workerIds: string[];
+                requestIds?: string[] | undefined;
+                requestOutcomes?: {
+                    requestId: string;
+                    status: "cancelled" | "completed-without-reply" | "deleted" | "destroyed" | "failed" | "human-fallback" | "replied" | "replied-late" | "sender-closed" | "timed-out";
+                    observedAt: string;
+                    replyId?: string | undefined;
+                }[] | undefined;
+                deadline: string;
+                mode?: "all" | "any" | "one" | undefined;
+                revisions?: {
+                    workerId: string;
+                    revision: number;
+                }[] | undefined;
+                reason?: "cancelled" | "message" | "outcome" | "timeout" | undefined;
+                phase: "parked" | "registered" | "wake-pending";
+                outcomes: {
+                    workerId: string;
+                    status: "cancelled" | "done" | "failed" | "review";
+                    observedAt: string;
+                    summary?: string | undefined;
+                    revision?: number | undefined;
+                }[];
+                wakeId?: string | undefined;
+            } | undefined;
+            results?: {
+                workerId: string;
+                revision: number;
+                snapshotId: string;
+                observedAt: string;
+                lastExecutionOutcome: "cancelled" | "completed" | "failed" | "review-ready" | "running";
+                previous?: {
+                    revision: number;
+                    observedAt: string;
+                    lastExecutionOutcome: "cancelled" | "completed" | "failed" | "review-ready" | "running";
+                } | undefined;
+            }[] | undefined;
+            finishRequestedAt?: string | undefined;
+            historyDeletion?: "pending" | undefined;
+            completion?: {
+                phase: "attention" | "waiting";
+                waitId?: string | undefined;
+            } | undefined;
+        } | {
+            role: "worker";
+            wait?: {
+                id: string;
+                workerIds: string[];
+                requestIds?: string[] | undefined;
+                requestOutcomes?: {
+                    requestId: string;
+                    status: "cancelled" | "completed-without-reply" | "deleted" | "destroyed" | "failed" | "human-fallback" | "replied" | "replied-late" | "sender-closed" | "timed-out";
+                    observedAt: string;
+                    replyId?: string | undefined;
+                }[] | undefined;
+                deadline: string;
+                mode?: "all" | "any" | "one" | undefined;
+                revisions?: {
+                    workerId: string;
+                    revision: number;
+                }[] | undefined;
+                reason?: "cancelled" | "message" | "outcome" | "timeout" | undefined;
+                phase: "parked" | "registered" | "wake-pending";
+                outcomes: {
+                    workerId: string;
+                    status: "cancelled" | "done" | "failed" | "review";
+                    observedAt: string;
+                    summary?: string | undefined;
+                    revision?: number | undefined;
+                }[];
+                wakeId?: string | undefined;
+            } | undefined;
+            lastWait?: {
+                id: string;
+                workerIds: string[];
+                requestIds?: string[] | undefined;
+                requestOutcomes?: {
+                    requestId: string;
+                    status: "cancelled" | "completed-without-reply" | "deleted" | "destroyed" | "failed" | "human-fallback" | "replied" | "replied-late" | "sender-closed" | "timed-out";
+                    observedAt: string;
+                    replyId?: string | undefined;
+                }[] | undefined;
+                deadline: string;
+                mode?: "all" | "any" | "one" | undefined;
+                revisions?: {
+                    workerId: string;
+                    revision: number;
+                }[] | undefined;
+                reason?: "cancelled" | "message" | "outcome" | "timeout" | undefined;
+                phase: "parked" | "registered" | "wake-pending";
+                outcomes: {
+                    workerId: string;
+                    status: "cancelled" | "done" | "failed" | "review";
+                    observedAt: string;
+                    summary?: string | undefined;
+                    revision?: number | undefined;
+                }[];
+                wakeId?: string | undefined;
+            } | undefined;
+            permissions: ("destroy" | "diff" | "inspect" | "spawn" | "steer" | "stop" | "wait")[];
+            parentRunId: string;
+            workspace: {
+                ownerRunId: string;
+                resourceId: string;
+                kind: "owned-isolated";
+                path: string;
+                branch: string;
+                baselineSha: string;
+            };
+            destroy?: {
+                requestedAt: string;
+                phase: "cleaning" | "complete" | "incomplete" | "requested" | "terminating";
+                remaining: ("branch" | "process" | "worktree")[];
+                error?: string | undefined;
+            } | undefined;
+            context?: {
+                text?: string | undefined;
+                inputs: {
+                    source: {
+                        kind: "parent-file";
+                        path: string;
+                    } | {
+                        kind: "baseline-file";
+                        path: string;
+                    } | {
+                        kind: "parent-attachment";
+                        id: string;
+                    };
+                    path: string;
+                    sha256: string;
+                    bytes: number;
+                }[];
+            } | undefined;
+            executionRevision?: number | undefined;
+            executionStartSeq?: number | undefined;
+        } | {
+            role: "invalid";
+        } | undefined;
+        lastWaitsError?: string | undefined;
+        automaticWakes?: number | undefined;
+        waitDeliveryFailures?: number | undefined;
+        runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+        notify?: boolean | undefined;
+        webhook?: {
+            lastDeliveredAt?: string | undefined;
+            lastError?: string | undefined;
+            lastErrorWebhookId?: string | undefined;
+        } | undefined;
+        destroyRetry?: {
+            attempts: number;
+            nextAt: string;
+            needsAttention?: true | undefined;
+        } | undefined;
+        stopping?: boolean | undefined;
+        hasPendingPermission?: boolean | undefined;
+        autoResumeAt?: string | undefined;
+        autoResumeAttempts?: number | undefined;
+        pullRequests?: {
+            number: number;
+            url?: string | undefined;
+            source: "created" | "declared";
+        }[] | undefined;
+        worktreeSetup?: {
+            status: "done" | "failed" | "running";
+            startedAt: string;
+            finishedAt?: string | undefined;
+            durationMs?: number | undefined;
+            error?: string | undefined;
+        } | undefined;
+        archived: boolean;
+        workflowDef?: {
+            name: string;
+            description?: string | undefined;
+            steps: {
+                id: string;
+                name?: string | undefined;
+                prompt?: string | undefined;
+                skill?: string | undefined;
+                model?: string | undefined;
+                effort?: string | undefined;
+                timeoutMs?: number | undefined;
+                runner?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+                agentProfile?: string | undefined;
+                allowedTools?: string[] | undefined;
+                bashAllowlist?: string[] | undefined;
+                command?: string | undefined;
+                onFail?: {
+                    retry: string;
+                    max: number;
+                } | undefined;
+            }[];
+            source: "built-in" | "file";
+            path?: string | undefined;
+        } | undefined;
+        steps: {
+            id: string;
+            name: string;
+            kind: "agent" | "check";
+            status: "cancelled" | "done" | "failed" | "pending" | "review" | "running" | "skipped" | "waiting";
+            iterations: number;
+            retriesUsed?: number | undefined;
+            tokensUsed: number;
+            inputTokens?: number | undefined;
+            outputTokens?: number | undefined;
+            usageInvocationsStarted?: number | undefined;
+            usageInvocationsObserved?: number | undefined;
+            usageTurnsStarted?: number | undefined;
+            usageTurnsRecorded?: number | undefined;
+            usageInvocationEpoch?: number | undefined;
+            startedAt?: string | undefined;
+            finishedAt?: string | undefined;
+            error?: string | undefined;
+            sessionId?: string | undefined;
+            sessionTransport?: "cursor-acp" | "cursor-print" | undefined;
+            profileId?: string | undefined;
+            costUsd?: number | undefined;
+            synthetic?: "continuation" | undefined;
+            backend?: "claude" | "codex" | "cursor" | "omp" | "opencode" | "pi" | undefined;
+        }[];
+        automation?: {
+            automationId: string;
+            receiptId: string;
+            event: string;
+            automationRevision: number;
+            githubUrl: string;
+        } | undefined;
+        automationTrigger?: {
+            automationId: string;
+            receiptId: string;
+            trigger: "catch-up" | "manual" | "schedule";
+            occurrenceAt: string;
+            automationRevision: number;
+        } | undefined;
+        handoffRecords?: {
+            autosave: {
+                at: string;
+                note: string;
+                periodic?: {
+                    branch: string | null;
+                    count: number;
+                    first: string | null;
+                    latest: string | null;
+                } | undefined;
+            }[];
+        } | undefined;
+    } | undefined): ExitFileRoots;
+    /** Start what resolves an open wait: the watch adapter its row names. An overdue deadline
+     *  (restart) resolves at once. */
+    private armWait;
+    /** A timer, peer or subagent deadline. Native subagents live only in their session: with none,
+     *  as at a restart, they stopped (hearsay-tools/cezarion#2431). At its deadline a lost session
+     *  reads the same. */
+    private armDeadline;
+    /**
+     * A worker wait's deadline re-observes its family (hearsay-tools/cezarion#1235): the reconcile
+     * resolves it with `timeout`, keeping any outcome observed by then. A failed checkpoint is
+     * retried every second while the wait is still open, never dropped as an uncaught error. An
+     * outcome whose resolution failed to commit arms the same retry with `firstDelay` 1 second.
+     */
+    private armWorkerDeadline;
+    /** Stop everything that could still resolve this wait. */
+    private disarmWait;
+    /**
+     * Watch a process wait's command (hearsay-tools/cezarion#1446). Like a timer, its wake is the
+     * agent's own arrangement: a stopping, stopped or finishing run takes none, and the wait stays
+     * open for that transition to cancel.
+     */
+    private startProcessWatch;
+    private startCiWatch;
+    /** `resolveWait`, retried while its durable checkpoint is unavailable: a failed write may not
+     *  drop the accepted intent or publish a false result. */
+    settleWait(runId: string, waitId: string, result?: WaitResult): void;
+    private disarmRun;
+    /** Re-arm the caller's recovery snapshot. Do not re-read between waits: an overdue
+     *  deadline can resolve synchronously, but the remaining snapshot entries still arm. */
+    rearm(run: RunRecord): void;
+    disposeWatches(): void;
+    disposeRetries(): void;
+    dispose(): void;
+    /** The open peer waits of these runs whose named peer already wrote, settled or was deleted resolve now. */
+    resolvePeerWaits(runIds: readonly string[]): void;
+    /** Like a timer, the wake is the agent's own arrangement: a stopping or finishing run takes none,
+     *  and the wait stays for that transition to cancel. True when the wait is no longer open. */
+    private resolvePeerWait;
+    /** Commit an open wait as resolved together with its lifecycle input (id = wait id, or an
+     *  upgraded worker wait's `wakeInputId`), then queue the run's wake. A worker wait passes the
+     *  entry as reconciled, with its outcomes and `result`. Throws when the checkpoint fails; a wait
+     *  no longer open is ignored. */
+    resolveWait(runId: string, waitId: string, result?: WaitResult, observed?: WorkerWaitEntry): void;
+    /** A worker's current status, as a worker wait's result names it. */
+    readonly workerStatus: (workerId: string) => string;
+    resolveWorkerWait(runId: string, entry: WorkerWaitEntry, observed: WorkerWaitEntry): boolean;
+    /** Keep watches armed until cancellation is durable. A skipped write disarms nothing. */
+    cancel(runId: string, ids: readonly string[], opts?: CancelWaitsOptions): Wait[];
+    /**
+     * Cancel every open or resolved wait of a run without waking the agent: stop, Finish, cancel,
+     * deletion, DONE and any terminal status. Human input cancels none (hearsay-tools/cezarion#1233).
+     * A failed commit leaves the record as a crash would and never stops the disarm, so Stop still
+     * reaches the session when the store is closed or broken (hearsay-tools/cezarion#1234).
+     */
+    cancelAll(runId: string): void;
+    /** Stop every watch, timer, retry and queued wake a run's waits hold in memory. */
+    forgetRun(runId: string): void;
+}
+export {};