@hearsay-tools/squawk 0.0.0-stage → 0.17.0-pr3058.5683

package/dist/workflows/run/human-waits.js

@@ -0,0 +1,163 @@
+import { logPrefix } from '../../home/display.js';
+import { WAIT_KINDS } from './wait-kinds.js';
+import { transitionTurnBoundary } from './turn-boundary.js';
+import { randomUUID } from 'node:crypto';
+import { PROSE_HUMAN_GATE } from '../../runs/transcript-facts.js';
+import { NO_WAIT_NOTE } from '../turn-end.js';
+import { isCezarHumanWait, openWaits } from '../waits.js';
+import { clearHeldHumanInputTimer, clearUnreadInputTimer } from './input-timers.js';
+import { hasPendingHumanAsk, pendingHumanAskSeq } from './pending-ask-facts.js';
+import { askCardFields, humanWaitCard } from './turn-markers.js';
+/** Opens, surfaces and withdraws human waits without owning a live session. */
+export class HumanWaits {
+    context;
+    host;
+    maxAutoContinues;
+    constructor(context, host, maxAutoContinues) {
+        this.context = context;
+        this.host = host;
+        this.maxAutoContinues = maxAutoContinues;
+    }
+    /** Ask precedence: the question is pending, and no autonomous nudge goes beside it. Durable
+     *  input and waits stay queued until an actual human answer. */
+    prepareHumanAsk(state) {
+        transitionTurnBoundary(state, { kind: 'human-wait-opened', phase: 'prepare', session: state.liveSession.session });
+    }
+    /** The human gate a human wait without a card raises (live workers with re-checks off):
+     * `PROSE_HUMAN_GATE` names it in the transcript. Keep the checkpoint through idle closure/restart
+     * and hold worker input until a successful human delivery, just as for a structured ask. */
+    raiseHumanGate(runId, state) {
+        this.context.store.appendEvent(runId, { type: 'note', stepId: state.liveSession.currentStepId,
+            code: PROSE_HUMAN_GATE, message: 'waiting for a human response to the assistant’s request' });
+        this.prepareHumanAsk(state);
+        clearUnreadInputTimer(state);
+        clearHeldHumanInputTimer(state);
+    }
+    /** The open human wait nobody has shown the user yet (hearsay-tools/cezarion#1234): one this
+     *  turn registered, or one a failure, close or crash caught before its turn end. */
+    unsurfacedHumanWait(runId) {
+        return WAIT_KINDS.human.select(openWaits(this.context.store.getRun(runId) ?? {})).find(wait => wait.askSeq === undefined);
+    }
+    /** The human wait this turn end raises: one nobody has seen yet. One registered while a question
+     *  is pending waits on that question instead, and raises nothing. */
+    turnEndHumanWait(runId) {
+        const wait = this.unsurfacedHumanWait(runId);
+        if (!wait || !hasPendingHumanAsk(runId, id => pendingHumanAskSeq(this.context.store, id)))
+            return wait;
+        this.markHumanWaitSurfaced(runId, wait);
+        return undefined;
+    }
+    /** An alias's human wait, or the one already open: a run holds one. A full list opens none. */
+    openHumanAlias(runId, state, via, card) {
+        const run = this.context.store.getRun(runId);
+        if (!run)
+            return undefined;
+        const source = WAIT_KINDS.human.aliasSource(via);
+        if (source === 'agent')
+            this.withdrawCezarHumanWaits(runId);
+        const existing = WAIT_KINDS.human.select(openWaits(this.context.store.getRun(runId) ?? run))[0];
+        if (existing)
+            return existing;
+        if (!this.host.waitEngine.hasRoom(this.context.store.getRun(runId) ?? {}))
+            return undefined;
+        const wait = WAIT_KINDS.human.aliasEntry(source, via, state?.waitIdentity.ciTurnId ?? via, card ? askCardFields(card) : undefined);
+        return this.host.waitEngine.open(runId, state, wait, { withdraw: false, onCommitFailure: { log: `${logPrefix()} human wait checkpoint failed` }, park: false }).wait;
+    }
+    /** Record which question a human wait is shown as: the pending card or gate, whose answer settles
+     *  it. A card shown in place of the wait's own replaces it. A wait already shown is left alone. */
+    markHumanWaitSurfaced(runId, wait, shownCard) {
+        const askSeq = pendingHumanAskSeq(this.context.store, runId);
+        const latest = WAIT_KINDS.human.select(this.context.store.getRun(runId)?.waits ?? []).find(entry => entry.id === wait.id);
+        if (askSeq === undefined || !latest || latest.phase !== 'open' || latest.askSeq !== undefined)
+            return;
+        const { questions: _questions, context: _context, ...kept } = latest;
+        const card = shownCard ?? humanWaitCard(latest);
+        try {
+            this.context.store.commitWait(runId, { ...kept, ...(card ? askCardFields(card) : {}), askSeq });
+        }
+        catch (error) {
+            console.warn(`${logPrefix()} human wait checkpoint failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Show a human wait outside its turn end (hearsay-tools/cezarion#1234): at a boundary, at the
+     * budget, or from the failure, close and recovery paths, where no turn end will. A card raises
+     * `ask.requested` and goes to a worker's parent; a wait without one raises the human gate. A
+     * question already pending is the one it waits on. A wait already shown is left alone. Cezar's
+     * own wait is shown as its note instead (`showCezarHumanWait`).
+     */
+    surfaceHumanWait(runId, state, wait = this.unsurfacedHumanWait(runId)) {
+        if (!wait || wait.askSeq !== undefined)
+            return;
+        if (wait.source === 'cezar') {
+            this.showCezarHumanWait(runId, state, wait);
+            return;
+        }
+        if (pendingHumanAskSeq(this.context.store, runId) === undefined) {
+            const run = this.context.store.getRun(runId);
+            const stepId = state?.liveSession.currentStepId ?? run?.currentStepId ?? run?.steps.at(-1)?.id;
+            if (wait.questions) {
+                this.context.store.appendEvent(runId, { type: 'ask.requested', requestId: randomUUID(), ...askCardFields({ questions: wait.questions, context: wait.context }), ...(stepId ? { stepId } : {}) });
+                if (state)
+                    this.prepareHumanAsk(state);
+            }
+            else if (state)
+                this.raiseHumanGate(runId, state);
+            else {
+                this.context.store.appendEvent(runId, { type: 'note', ...(stepId ? { stepId } : {}), code: PROSE_HUMAN_GATE, message: 'waiting for a human response to the assistant’s request' });
+            }
+        }
+        else if (state)
+            transitionTurnBoundary(state, { kind: 'human-wait-opened', phase: 'refresh-question', session: state.liveSession.session, pending: true });
+        this.markHumanWaitSurfaced(runId, wait);
+        this.host.routeWorkerQuestion(runId);
+    }
+    /**
+     * Cezar's own human wait (`no-wait`, `budget`) is shown as a note, recorded as its `askSeq`, and
+     * raises no human gate (hearsay-tools/cezarion#1234). The agent asked nothing: the run waits for
+     * the user as the plain park did before these waits, so worker messages still wake it and its
+     * wait registrations, `cezar_done` and the user's Finish are not refused. The user's message
+     * settles it, and the agent's own wait or question replaces it (`withdrawCezarHumanWaits`).
+     */
+    showCezarHumanWait(runId, state, wait, note) {
+        const run = this.context.store.getRun(runId);
+        const stepId = state?.liveSession.currentStepId ?? run?.currentStepId ?? run?.steps.at(-1)?.id;
+        const shown = this.context.store.appendEvent(runId, { type: 'note', ...(stepId ? { stepId } : {}),
+            message: note ?? (wait.via === 'no-wait' ? NO_WAIT_NOTE : wait.via === 'completion' ? 'completion blocked; waiting for you'
+                : `automatic-wake budget spent (${this.maxAutoContinues}); waiting for you`) });
+        const latest = WAIT_KINDS.human.select(run?.waits ?? []).find(entry => entry.id === wait.id);
+        if (!latest || latest.phase !== 'open' || latest.askSeq !== undefined)
+            return;
+        try {
+            this.context.store.commitWait(runId, { ...latest, askSeq: shown.seq });
+        }
+        catch (error) {
+            console.warn(`${logPrefix()} human wait checkpoint failed: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /** Cezar waited on the user only because the agent had nothing to wait on: the agent's own wait
+     *  or question replaces that wait (hearsay-tools/cezarion#1234). It also ends with the session
+     *  that opened it, so a close, an idle close or a failure settles as the plain park did. */
+    withdrawCezarHumanWaits(runId) {
+        const ids = openWaits(this.context.store.getRun(runId) ?? {}).filter(isCezarHumanWait).map(wait => wait.id);
+        if (!ids.length)
+            return;
+        this.host.waitEngine.cancel(runId, ids, { onCommitFailure: 'skip', log: `${logPrefix()} human wait checkpoint failed` });
+    }
+    /** Whether a closing session leaves the run waits to park on. Cezar's own human waits end with the
+     *  session, even when the store refused their cancellation (`withdrawCezarHumanWaits`). */
+    holdsAgentWaits(runId) {
+        return (this.context.store.getRun(runId)?.waits ?? []).some(wait => !isCezarHumanWait(wait));
+    }
+    /** Read fresh: a boundary the turn end re-enters (Cursor print's ready callback from
+     *  `discardQueuedMessages`) may have shown the wait already, and its card stands. */
+    humanWaitShown(runId, wait) {
+        return !!wait && WAIT_KINDS.human.select(this.context.store.getRun(runId)?.waits ?? []).some(entry => entry.id === wait.id && entry.askSeq !== undefined) === true;
+    }
+    /** The turn end raised a card or the gate: record the human wait it shows. */
+    recordTurnEndQuestion(runId, wait, ask) {
+        if (wait)
+            this.markHumanWaitSurfaced(runId, wait, ask ?? undefined);
+    }
+}
+//# sourceMappingURL=human-waits.js.map

package/dist/workflows/run/human-waits.js.map

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

package/dist/workflows/run/inbox-claims.d.ts

@@ -0,0 +1,38 @@
+import type { AgentSession } from '../../core/agent-runner.ts';
+import type { RunRecord } from '../../runs/store.ts';
+import type { ActiveRun } from '../active-run.ts';
+import type { RunModuleContext } from './types.ts';
+interface InboxClaimsHost {
+    activeGet(runId: string): ActiveRun | undefined;
+    executionBlockedByRootFinish(run: RunRecord): boolean;
+    workerExecutionStopped(runId: string): boolean;
+    reconcileWorkerWaits(): void;
+    retireEmptyWake(runId: string): void;
+    deliverConversationInput(runId: string): void;
+    settleIdleBoundary(runId: string, state: ActiveRun, session: AgentSession): void;
+    releaseSlot(): void;
+    providerOwnsInboxInput(runId: string, id: string): boolean;
+    canClaimInboxInput(runId: string, id: string): boolean;
+    armInboxClaimExpiry(runId: string): void;
+}
+export declare class InboxClaims {
+    private readonly context;
+    private readonly host;
+    readonly inboxClaimTimers: Map<string, NodeJS.Timeout>;
+    constructor(context: RunModuleContext, host: InboxClaimsHost);
+    dispose(): void;
+    /** A wait wake is only a pointer. Only provider submission/opening prompts own delivery. */
+    providerOwnsInboxInput(runId: string, id: string): boolean;
+    canClaimInboxInput(runId: string, id: string): boolean;
+    /** The service supplies authorized, bounded IDs; claim and flight reservations are synchronous. */
+    reserveInboxInputs(runId: string, generation: string, ids: readonly string[]): {
+        receiptId: string;
+        expiresAt: string;
+        inputIds: string[];
+    } | undefined;
+    acknowledgeInbox(runId: string, generation: string, receiptId: string): 'acknowledged' | 'already-acknowledged';
+    releaseInbox(runId: string, generation: string, receiptId: string): 'released';
+    /** Expiry is an independent wake source, including after the provider's last turn. */
+    armInboxClaimExpiry(runId: string): void;
+}
+export {};

package/dist/workflows/run/inbox-claims.js

@@ -0,0 +1,108 @@
+import { logPrefix } from '../../home/display.js';
+import { randomUUID } from 'node:crypto';
+import { hasLiveInboxClaim } from '../../delegation/input.js';
+import { historyDeletionPending } from './run-guards.js';
+export class InboxClaims {
+    context;
+    host;
+    inboxClaimTimers = new Map();
+    constructor(context, host) {
+        this.context = context;
+        this.host = host;
+    }
+    dispose() {
+        for (const timer of this.inboxClaimTimers.values())
+            clearTimeout(timer);
+        this.inboxClaimTimers.clear();
+    }
+    /** A wait wake is only a pointer. Only provider submission/opening prompts own delivery. */
+    providerOwnsInboxInput(runId, id) {
+        const state = this.host.activeGet(runId);
+        return !!state?.inputState.agentInputFlight?.inputIds.includes(id) || state?.inputState.openingAgentInputId === id ||
+            this.context.store.getRun(runId)?.continuationMessage?.agentInputId === id;
+    }
+    canClaimInboxInput(runId, id) {
+        const run = this.context.store.getRun(runId);
+        const input = run?.agentInputs?.find(entry => entry.id === id);
+        return !this.context.disposed() && !!run && ['queued', 'running', 'waiting'].includes(run.status) &&
+            !historyDeletionPending(this.context.store, runId) && !this.host.executionBlockedByRootFinish(run) && !this.host.workerExecutionStopped(runId) &&
+            !!input && input.source === 'agent' && !!input.conversation && !input.deliveredAt &&
+            !hasLiveInboxClaim(input) && !this.host.providerOwnsInboxInput(runId, id);
+    }
+    /** The service supplies authorized, bounded IDs; claim and flight reservations are synchronous. */
+    reserveInboxInputs(runId, generation, ids) {
+        if (!ids.length || ids.some(id => !this.host.canClaimInboxInput(runId, id)) ||
+            this.context.store.getRun(runId)?.agentInputs?.some(input => !input.deliveredAt && hasLiveInboxClaim(input)))
+            return undefined;
+        const claim = { receiptId: randomUUID(), generation, expiresAt: new Date(Date.now() + 120_000).toISOString() };
+        this.context.store.claimInboxInputs(runId, ids, claim);
+        this.host.armInboxClaimExpiry(runId);
+        return { receiptId: claim.receiptId, expiresAt: claim.expiresAt, inputIds: [...ids] };
+    }
+    acknowledgeInbox(runId, generation, receiptId) {
+        if (this.context.disposed() || this.context.store.getRun(runId)?.agentInputs?.some(input => input.inboxClaim?.receiptId === receiptId &&
+            !input.deliveredAt && this.host.providerOwnsInboxInput(runId, input.id)))
+            throw new Error('inbox receipt displaced');
+        const result = this.context.store.ackInboxInputs(runId, receiptId, generation, new Date().toISOString());
+        this.host.armInboxClaimExpiry(runId);
+        this.host.reconcileWorkerWaits();
+        this.host.retireEmptyWake(runId);
+        this.host.deliverConversationInput(runId);
+        // A done the turn end kept behind this claim settles now that the input is read: the inbox
+        // acknowledgement is the boundary's last owed input (hearsay-tools/cezarion#1620).
+        const state = this.host.activeGet(runId);
+        if (state?.liveSession.session?.open)
+            this.host.settleIdleBoundary(runId, state, state.liveSession.session);
+        this.host.releaseSlot();
+        return result;
+    }
+    releaseInbox(runId, generation, receiptId) {
+        if (this.context.disposed())
+            throw new Error('inbox manager disposed');
+        const result = this.context.store.releaseInboxInputs(runId, receiptId, generation);
+        this.host.armInboxClaimExpiry(runId);
+        this.host.reconcileWorkerWaits();
+        this.host.deliverConversationInput(runId);
+        this.host.releaseSlot();
+        return result;
+    }
+    /** Expiry is an independent wake source, including after the provider's last turn. */
+    armInboxClaimExpiry(runId) {
+        const previous = this.inboxClaimTimers.get(runId);
+        if (previous)
+            clearTimeout(previous);
+        this.inboxClaimTimers.delete(runId);
+        if (this.context.disposed())
+            return;
+        const deadlines = (this.context.store.getRun(runId)?.agentInputs ?? []).flatMap(input => input.inboxClaim && !input.inboxClaim.acknowledgedAt ? [Date.parse(input.inboxClaim.expiresAt)] : []);
+        if (!deadlines.length)
+            return;
+        let warned = false;
+        const expire = () => {
+            this.inboxClaimTimers.delete(runId);
+            if (this.context.disposed() || !this.context.store.getRun(runId))
+                return;
+            try {
+                this.context.store.clearExpiredInboxClaims(runId, new Date().toISOString());
+                this.host.reconcileWorkerWaits();
+                this.host.deliverConversationInput(runId);
+                this.host.armInboxClaimExpiry(runId);
+                this.host.releaseSlot();
+            }
+            catch {
+                if (!warned)
+                    console.warn(`${logPrefix()} inbox expiry checkpoint failed; retrying in 1 second`);
+                warned = true;
+                if (!this.context.disposed())
+                    arm(1_000);
+            }
+        };
+        const arm = (delay) => {
+            const timer = setTimeout(expire, delay);
+            timer.unref?.();
+            this.inboxClaimTimers.set(runId, timer);
+        };
+        arm(Math.max(0, Math.min(...deadlines) - Date.now()));
+    }
+}
+//# sourceMappingURL=inbox-claims.js.map

package/dist/workflows/run/inbox-claims.js.map

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

package/dist/workflows/run/input-batch.d.ts

@@ -0,0 +1,15 @@
+import type { AgentInput } from '../../contract/index.js';
+import type { RunRecord } from '../../runs/store.ts';
+import type { ActiveRun } from '../active-run.ts';
+/** The conversation messages the next submission would carry, if nothing but
+ * conversation input leads the queue (lifecycle input stays a barrier). */
+export declare function pendingConversationBatch(run: RunRecord | undefined, state: ActiveRun, formatAgentInput: (input: AgentInput) => string, answerId?: string): {
+    inputs: AgentInput[];
+    text: string;
+} | undefined;
+/** A batch with timer results is an automatic wake, and so is an admitted wake turn a peer message
+ *  opens (spec 2026-10-27-task-communication-protocol § 8). Past the budget a peer message opens
+ *  no turn (`pendingConversationWakes`), so one carried by another wake is free. */
+export declare function reservesAutomaticWake(run: RunRecord | undefined, flight: NonNullable<ActiveRun['inputState']['agentInputFlight']>, inputIds: readonly string[], automaticWakes: () => number, MAX_AUTO_CONTINUES: number): boolean;
+export declare function formatAgentInput(input: AgentInput, getRun: (runId: string) => RunRecord | undefined): string;
+export declare function agentInputOutcomeText(input: AgentInput, root: RunRecord | undefined): string;

package/dist/workflows/run/input-batch.js

@@ -0,0 +1,32 @@
+import { WAIT_KINDS } from './wait-kinds.js';
+import { agentInputBatch } from '../../delegation/input.js';
+import { chargesBudget, chargesBudgetMessage, resolvedWaits } from '../waits.js';
+/** The conversation messages the next submission would carry, if nothing but
+ * conversation input leads the queue (lifecycle input stays a barrier). */
+export function pendingConversationBatch(run, state, formatAgentInput, answerId) {
+    // The answer this batch rides on settles every human wait, so only a CI or timer wait holds it
+    // (hearsay-tools/cezarion#1234).
+    if (!run || run.waits?.some(wait => !WAIT_KINDS[wait.kind].userAnswers) || state.inputState.agentInputFlight)
+        return undefined;
+    const batch = agentInputBatch((run.agentInputs ?? []).filter(input => input.id !== state.inputState.openingAgentInputId && input.id !== answerId), input => formatAgentInput(input));
+    return batch?.inputs.every(input => input.conversation) ? batch : undefined;
+}
+/** A batch with timer results is an automatic wake, and so is an admitted wake turn a peer message
+ *  opens (spec 2026-10-27-task-communication-protocol § 8). Past the budget a peer message opens
+ *  no turn (`pendingConversationWakes`), so one carried by another wake is free. */
+export function reservesAutomaticWake(run, flight, inputIds, automaticWakes, MAX_AUTO_CONTINUES) {
+    if (resolvedWaits(run ?? {}).some(wait => chargesBudget(wait) && inputIds.includes(wait.id)))
+        return true;
+    return !!flight.admittedWake && automaticWakes() < MAX_AUTO_CONTINUES &&
+        !!run?.agentInputs?.some(input => inputIds.includes(input.id) && chargesBudgetMessage(input));
+}
+export function formatAgentInput(input, getRun) {
+    const attribution = input.conversation;
+    const text = attribution ? `Agent conversation ${JSON.stringify({ id: input.id, ...attribution })}\n${input.text}` : input.text;
+    return text + agentInputOutcomeText(input, getRun(input.parentRunId));
+}
+export function agentInputOutcomeText(input, root) {
+    const outcome = input.conversation && root?.delegation?.role === 'root' ? root.delegation.conversation?.outcomes.find(entry => entry.requestId === (input.conversation?.requestId ?? input.id)) : undefined;
+    return outcome ? `\nRequest outcome: ${outcome.status}. This delivery does not reopen the settled request.` : '';
+}
+//# sourceMappingURL=input-batch.js.map

package/dist/workflows/run/input-batch.js.map

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

package/dist/workflows/run/input-delivery.d.ts

@@ -0,0 +1,202 @@
+import type { WaitEngine } from './wait-engine.ts';
+import type { AgentInput } from '../../contract/index.js';
+import type { Wait } from '../../contract/index.js';
+import type { InputDelivery as InputDeliveryPolicy } from '../../core/agent-runner.ts';
+import type { ContentBlock } from '../../core/agent-runner.ts';
+import type { AgentSession } from '../../core/claude-cli-runner.ts';
+import type { RunRecord } from '../../runs/store.ts';
+import type { ContinueRunOptions } from '../continuation-admission.ts';
+import { type ActiveRun } from '../active-run.ts';
+import type { PastedContent } from '../pasted-content.ts';
+import type { RunExitId } from '../../runs/run-exits.ts';
+import * as inputReceipts from './input-receipts.ts';
+import type { RunModuleContext, SettledTurn } from './types.ts';
+import type { RunLine } from './run-line.ts';
+import type { WorkerExecutions } from './worker-executions.ts';
+import type { RunSkills } from './run-skills.ts';
+import type { AttachmentWriter } from './attachment-writer.ts';
+import type { HumanWaits } from './human-waits.ts';
+import type { WorkerQuestions } from './worker-questions.ts';
+export declare class InputFlight {
+    #private;
+    constructor(session: AgentSession, inputIds: readonly string[], admittedWake?: boolean);
+    get session(): AgentSession;
+    get inputIds(): readonly string[];
+    get settled(): Promise<void> | undefined;
+    /** Counts one reserved automatic wake until its ACK spends or refunds it. */
+    get wakeReserved(): boolean | undefined;
+    /** An admitted message-only wake spends its admission too. */
+    get admittedWake(): boolean | undefined;
+}
+/** Input transport, receipt and liveness state. All mutation commands live in this module. */
+export declare class InputGroup {
+    #private;
+    constructor();
+    get agentInputError(): string | undefined;
+    get agentInputFlight(): InputFlight | undefined;
+    get inputDelivery(): InputDeliveryPolicy | undefined;
+    /** Accepted by an observable harness, awaiting its read report. */
+    get unreadInputIds(): ReadonlySet<string> | undefined;
+    /** Reads reported before their acceptance checkpoint. */
+    get consumedBeforeAck(): ReadonlySet<string> | undefined;
+    /** Messages carried behind a human answer, read at that turn's end. */
+    get bundledInputIds(): readonly string[] | undefined;
+    /** Unread reports received while the same submission's ACK is pending. */
+    get retiredInFlight(): ReadonlySet<string> | undefined;
+    get unreadInputTimer(): NodeJS.Timeout | undefined;
+    get unreadRetried(): ReadonlySet<string> | undefined;
+    get heldHumanInputTimer(): NodeJS.Timeout | undefined;
+    get heldHumanInputSince(): number | undefined;
+    get heldHumanInputExpired(): boolean | undefined;
+    /** Only the older ask answered by this continuation's opening turn. */
+    get openingAnswerAskSeq(): number | undefined;
+    get openingAgentInputId(): string | undefined;
+    /** A turn started synchronously inside Cezar's write belongs to that write. */
+    get writingInput(): boolean | undefined;
+    recordInputError(message: string): void;
+    attachFlight(flight: InputFlight): void;
+    clearFlight(): void;
+    declareDelivery(delivery: InputDeliveryPolicy): void;
+    resetUnreadInputs(): void;
+    resetEarlyConsumption(): void;
+    recordEarlyConsumption(id: string): void;
+    forgetEarlyConsumption(id: string): void;
+    recordUnreadInput(id: string): void;
+    forgetUnreadInput(id: string): void;
+    clearUnreadInputs(): void;
+    bundleInputs(ids: readonly string[]): void;
+    clearBundledInputs(): void;
+    retireInFlight(id: string): void;
+    forgetRetiredInput(id: string): void;
+    prepareUnreadRetry(): void;
+    recordUnreadRetry(id: string): void;
+    retainUnreadTimer(timer: NodeJS.Timeout): void;
+    unreadTimerFired(): void;
+    clearUnreadTimer(): void;
+    retainHeldTimer(timer: NodeJS.Timeout): void;
+    heldTimerFired(): void;
+    clearHeldTimer(resetClock?: boolean): void;
+    clearHeldClock(): void;
+    beginHeldClock(): void;
+    expireHeldInput(): void;
+    answerOpeningAsk(seq: number | undefined): void;
+    clearOpeningAnswer(): void;
+    selectOpeningInput(id: string | undefined): void;
+    writeInput<T>(write: () => T): T;
+}
+export declare function createInputGroup(): InputGroup;
+type HumanAnswerBudget = {
+    spent: number;
+};
+/** Charging results cancelled by this flush, before a human answer resets its budget. */
+export declare function cappedTimersBeforeFlush(run: RunRecord, beforeHumanReset: HumanAnswerBudget | undefined, reads: {
+    countAutomaticWakes(before?: HumanAnswerBudget): number;
+    isAdmitted(): boolean;
+    atTurnBoundary(): boolean;
+}, maxAutoContinues: number): Wait[];
+export declare const HELD_HUMAN_INPUT_RECHECK_MS = 250;
+interface InputDeliveryHost {
+    active: ReadonlyMap<string, ActiveRun>;
+    line: RunLine;
+    workerExecutions: WorkerExecutions;
+    runSkills: RunSkills;
+    attachments: AttachmentWriter;
+    humanWaits: HumanWaits;
+    workerQuestions: WorkerQuestions;
+    waitEngine: WaitEngine;
+    inputReceiptHost: inputReceipts.InputReceiptsHost;
+    isActive(id: string): boolean;
+    move(id: string, exit: RunExitId): unknown;
+    workerExecutionStopped(id: string): boolean;
+    executionBlockedByRootFinish(run: RunRecord): boolean;
+    hasUnansweredHumanAsk(id: string): boolean;
+    countAutomaticWakes(id: string, budget?: HumanAnswerBudget): number;
+    recoveringRun(id: string): boolean;
+    continueRun(id: string, opts: ContinueRunOptions, defer: boolean): {
+        ok: boolean;
+        error?: string;
+    };
+    canProceedWithRun(id: string, run: RunRecord | undefined): boolean;
+    parkForUser(id: string, state: ActiveRun, step: string | undefined): void;
+    settleTurn(id: string, state: ActiveRun, entry: 'ack' | 'ready', turn: SettledTurn): boolean;
+    boundaryTurn(id: string, state: ActiveRun, session: AgentSession, done: boolean): SettledTurn;
+    canAutoContinue(id: string, state: ActiveRun): boolean;
+    armNoWaitNudgeReplyTimer(id: string, state: ActiveRun): void;
+    awaitCompletionNudgeReply(id: string, state: ActiveRun, session: AgentSession): void;
+    queueWaitWake(id: string): void;
+    owesWake(run: RunRecord, budget?: HumanAnswerBudget): boolean;
+    pendingConversationWakes(run: RunRecord, budget?: HumanAnswerBudget): AgentInput[];
+    routedAnswer(id: string): AgentInput | undefined;
+    spendWakeAdmission(id: string, state: ActiveRun, owed: boolean): void;
+    cancelAutomaticAtCap(id: string, waits: readonly Wait[]): void;
+    reparkWithoutWaits(id: string, state: ActiveRun): void;
+    holdPeerWakesAtCap(id: string): void;
+    reconcileWorkerWaits(): void;
+    unreadInputGraceMs(): number;
+    submitAgentInput(id: string, state: ActiveRun, content: ContentBlock[], inputs?: readonly string[], budget?: HumanAnswerBudget): boolean;
+}
+export declare class InputDelivery {
+    private readonly context;
+    private readonly host;
+    private readonly maxAutoContinues;
+    private readonly routedQuestionRefusal;
+    constructor(context: RunModuleContext, host: InputDeliveryHost, maxAutoContinues: number, routedQuestionRefusal: string);
+    steerWorker(runId: string, input: AgentInput): 'queued' | 'delivered';
+    sendMessage(runId: string, content: PastedContent[], messageId?: string): boolean;
+    respondPermission(runId: string, requestId: string, optionId: string): boolean;
+    /** Latch an agent input error, then interrupt: a transport failure the interrupt causes is secondary. */
+    latchAgentInputError(runId: string, state: ActiveRun, session: AgentSession, message: string): void;
+    deliverConversationInput(runId: string): void;
+    /** The parent's reply answers the routed question like a human answer would: through the
+     * live session's native answer seam, or by reopening a session that is gone (#505). */
+    answerRoutedQuestion(runId: string, admitted?: boolean): void;
+    private pendingRoutedAnswer;
+    private reopenRoutedAnswer;
+    private deliverRoutedAnswer;
+    /** Accepted input may be temporarily refused while a backend HTTP ack is
+     * outstanding. That is not an empty queue and must not trigger automatic DONE. `except` leaves
+     * out inputs already submitted, such as an acknowledgement still in flight. */
+    hasQueuedAgentInputs(runId: string, except?: readonly string[]): boolean;
+    /** An idle, open boundary with nothing left to deliver: DONE closes, otherwise the
+     * run parks as waiting or monitoring. Shared by acknowledgements that land after a
+     * turn ended and by the unread-input grace timer (#505). */
+    settleIdleBoundary(runId: string, state: ActiveRun, session: AgentSession): void;
+    private reparkPendingQuestion;
+    /** #505 liveness bound: a harness that accepted input and then neither read it nor ran
+     * another turn must not hold the run and its slot forever. After a quiet grace window the
+     * input is resubmitted once; after a second it is left delivered but unconfirmed. */
+    armUnreadInputTimer(runId: string, state: ActiveRun): void;
+    /** #486: a turn-end deferred close/park only because the harness still held a human follow-up. */
+    armHeldHumanInputTimer(runId: string, state: ActiveRun): void;
+    private inputReadyAuthorized;
+    /** A callback from an old/replaced/disposed session carries no authority. */
+    handleAgentInputReady(runId: string, state: ActiveRun, session: AgentSession | undefined): void;
+    /** Reservation is synchronous; only an acknowledged transport may checkpoint delivery. */
+    submitAgentInput(runId: string, state: ActiveRun, content: ContentBlock[], inputIds?: readonly string[], beforeHumanReset?: HumanAnswerBudget): boolean;
+    private recordAgentInputTurn;
+    private admitsAgentInput;
+    private sendAgentInput;
+    /** Apply the acknowledgement's effects only after its outcome commit succeeds. */
+    private applyAcknowledgedInput;
+    /** False leaves the durable entry untouched. The answer commits its reset before this flush,
+     *  but this one synchronous flush keeps the budget decisions it made before that reset
+     *  (hearsay-tools/cezarion#1906). Later acknowledgements read the restarted budget normally. */
+    flushAgentInputs(runId: string, beforeHumanReset?: HumanAnswerBudget): boolean;
+    private supersedeFallbackBeforeFlush;
+    private cancelCappedTimersBeforeFlush;
+    private flushAgentInputBatch;
+    /** Restore active lifecycle/accounting when either Cezar or the backend
+     * resumes work in a parked session. */
+    resumeParkedRun(runId: string, state: ActiveRun, beforeHumanReset?: HumanAnswerBudget): void;
+    /** Shared live-session delivery. Synthetic scheduler prompts reuse lifecycle
+     * bookkeeping without masquerading as user-authored transcript messages. */
+    deliverMessage(runId: string, content: PastedContent[], userAuthored: boolean, messageId?: string): boolean;
+    private prepareMessageContent;
+    private applyHumanMessageDelivery;
+}
+export declare function latchInputFault(reads: {
+    current(): boolean;
+    sessionFault(): string | undefined;
+    inputFault(): string | undefined;
+}): boolean;
+export {};