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

package/dist/workflows/run/worker-questions.js

@@ -0,0 +1,464 @@
+import { commandText } from '../../home/command.js';
+import { logPrefix } from '../../home/display.js';
+import { randomUUID } from 'node:crypto';
+import { askRequestOf } from '../../contract/index.js';
+import { enqueueAgentInput, hasLiveInboxClaim } from '../../delegation/input.js';
+import { commitNewMessage, inboxSlotsUsed, projectConversationEvents } from '../../delegation/conversations.js';
+import { answersQuestion, questionMessage, reservedReplies, uuidFrom } from '../../delegation/questions.js';
+import { messagedParentSince, parkNoticeIdInUse, parkNoticeMessage, parkNoticeWait, parkingTurn } from '../../delegation/park-notice.js';
+import { workerQuestionRouting } from '../question-routing.js';
+import { WORKER_FALLBACK_NOTE, WORKER_FALLBACK_REPLY_NOTE } from '../turn-end.js';
+import { historyDeletionPending, rootFinishRequested } from './run-guards.js';
+import { pendingHumanAskSeq, hasPendingHumanAsk } from './pending-ask-facts.js';
+/** A worker's second turn end with no wait or done asks its parent, as a routed open question
+ *  (hearsay-tools/cezarion#1301). */
+export const WORKER_FALLBACK_QUESTION = (workerId) => `Worker ${workerId} ended its turn without waiting on anything or finishing. Reply with what it should do next.`;
+export const WORKER_FALLBACK_HEADER = 'Worker idle';
+export class WorkerQuestions {
+    context;
+    host;
+    maxAutoContinues;
+    constructor(context, host, maxAutoContinues) {
+        this.context = context;
+        this.host = host;
+        this.maxAutoContinues = maxAutoContinues;
+    }
+    /** A worker's pending question goes to its owning parent as a conversation request (#505). The
+     * worker still parks on its ask; only the parent's reply answers it. A question with no live
+     * parent, or a worker that stopped, closes; one a live parent cannot take gets Cezar's answer
+     * with the reason (hearsay-tools/cezarion#2410). Routing is idempotent: the message ID derives
+     * from the ask seq. */
+    routeWorkerQuestion(workerId) {
+        const worker = this.context.store.getRun(workerId);
+        if (worker?.delegation?.role !== 'worker')
+            return;
+        const ask = this.context.store.transcriptFacts(workerId).pendingAsk;
+        if (!ask || ask.fallback)
+            return;
+        // A stopped worker's question closes first, whatever answer is queued for it: no conversation
+        // outcome closes a question that never reached the parent, and the close retires that answer.
+        if (!['queued', 'running', 'waiting'].includes(worker.status) || worker.stopping) {
+            this.closeQuestion(workerId, ask.seq, 'worker-stopped');
+            return;
+        }
+        if (this.undeliveredAnswer(workerId, ask.seq)) {
+            this.recordUndelivered(workerId, ask.seq, undefined);
+            return;
+        }
+        // A routed question whose parent can no longer be read cannot be answered there: Cezar answers it.
+        if (ask.routedMessageId !== undefined) {
+            this.answerForUnreadableParent(workerId, worker.delegation.parentRunId, ask.seq);
+            return;
+        }
+        const request = askRequestOf(ask);
+        if (!request) {
+            this.answerUndelivered(workerId, ask.seq, 'the question is not a valid request');
+            return;
+        }
+        const parentId = worker.delegation.parentRunId;
+        const root = this.context.store.getRun(parentId);
+        const now = new Date().toISOString();
+        const message = questionMessage({ workerRunId: workerId, parentRunId: parentId, askSeq: ask.seq, request, now });
+        // Already committed (a crash before the routing event): the question did reach the parent,
+        // whatever its capacity or state is now. Record the routing; the close sweeps follow.
+        const committed = root?.delegation?.role === 'root' && !!root.delegation.conversation?.messages.some(m => m.id === message.id);
+        if (committed) {
+            this.context.store.appendEvent(workerId, { type: 'worker-question-routed', askSeq: ask.seq, messageId: message.id, parentRunId: parentId });
+            return;
+        }
+        const routing = workerQuestionRouting(worker, root, { unreadable: id => this.context.store.isUnreadable(id),
+            parentEnding: parent => rootFinishRequested(this.context.store, parent.id) || historyDeletionPending(this.context.store, parent.id) });
+        if ('close' in routing) {
+            this.closeQuestion(workerId, ask.seq, routing.close);
+            return;
+        }
+        if ('undeliverable' in routing) {
+            this.answerUndelivered(workerId, ask.seq, routing.undeliverable);
+            return;
+        }
+        const { state } = routing;
+        const input = { id: message.id, source: 'agent', parentRunId: parentId, text: message.text, createdAt: now,
+            conversation: { senderRunId: workerId, recipientRunId: parentId, kind: 'request' } };
+        if (!commitNewMessage(this.context.store, parentId, { ...state, messages: [...state.messages, message] }, { recipientRunId: parentId, input }, () => this.answerUndelivered(workerId, ask.seq, 'its message ID is already in use in the parent conversation')))
+            return;
+        projectConversationEvents(this.context.store, this.context.store.getRun(parentId));
+        this.context.store.appendEvent(workerId, { type: 'worker-question-routed', askSeq: ask.seq, messageId: message.id, parentRunId: parentId });
+        this.host.deliverConversationInput(parentId);
+    }
+    /** A routed question whose parent record can no longer be read gets Cezar's answer. A reply the
+     *  parent sent before goes first, so the worker takes one answer. A reply a live inbox claim still
+     *  holds stays, and Cezar does not answer beside it: the next pass after it is taken does. A failed
+     *  write leaves this for the next pass too. */
+    answerForUnreadableParent(workerId, parentId, askSeq) {
+        if (!this.context.store.isUnreadable(parentId))
+            return;
+        try {
+            for (const id of this.queuedAnswerIds(workerId))
+                this.host.retireUnreadParentQuestion(workerId, id);
+        }
+        catch (error) {
+            console.warn(`${logPrefix()} parent reply not retired: ${error instanceof Error ? error.message : String(error)}`);
+            return;
+        }
+        if (this.queuedAnswerIds(workerId).length)
+            return;
+        this.answerUndelivered(workerId, askSeq, 'the parent record cannot be read');
+    }
+    /** The ID of Cezar's answer to a worker question that could not reach its parent: one per ask, so
+     *  a restart that routes again finds it instead of answering twice. */
+    undeliveredAnswerId(workerId, askSeq) {
+        return uuidFrom(`undelivered-question:${workerId}:${askSeq}`);
+    }
+    /** Cezar's answer to this ask, when one was queued (hearsay-tools/cezarion#2410). */
+    undeliveredAnswer(workerId, askSeq) {
+        const id = this.undeliveredAnswerId(workerId, askSeq);
+        return this.context.store.getRun(workerId)?.agentInputs?.find(input => input.id === id && input.purpose === 'undelivered-question');
+    }
+    /**
+     * A live parent cannot take the worker's question (hearsay-tools/cezarion#2410): Cezar answers it
+     * with the reason through the answer seam a parent's reply uses, so the worker decides what to do
+     * next and no human card holds it. The answer is queued with its automatic-wake charge, so a
+     * worker that asks again cannot loop past the budget. Cezar's own "Worker idle" question, a spent
+     * budget or a queue that refuses the answer closes the question instead, and the worker parks.
+     */
+    answerUndelivered(workerId, askSeq, reason) {
+        const run = this.context.store.getRun(workerId);
+        if (!run || this.undeliveredAnswer(workerId, askSeq))
+            return;
+        const ask = this.context.store.transcriptFacts(workerId).pendingAsk;
+        if (ask?.seq !== askSeq)
+            return;
+        const spent = this.host.countAutomaticWakes(workerId) + 1;
+        if (this.isWorkerFallbackAsk(workerId, askSeq) || spent > this.maxAutoContinues) {
+            this.closeQuestion(workerId, askSeq, 'undeliverable', reason);
+            return;
+        }
+        const parentId = run.delegation?.role === 'worker' ? run.delegation.parentRunId : workerId;
+        const notice = `Not delivered to your parent task ${parentId}: ${reason}. Decide without its answer, ${commandText('or message your parent later with cez message request.')}`;
+        const questions = askRequestOf(ask)?.questions;
+        // One `Header: answer` line per question, as a native answer seam parses a parent's reply.
+        const text = questions?.length ? questions.map(question => `${question.header}: ${notice}`).join('\n') : notice;
+        const input = { id: this.undeliveredAnswerId(workerId, askSeq), parentRunId: workerId, source: 'lifecycle', purpose: 'undelivered-question', text, createdAt: new Date().toISOString() };
+        try {
+            enqueueAgentInput(run, input);
+            this.context.store.commitOutcome(workerId, { kind: 'charged', automaticWakes: spent }, { enqueue: [input] });
+        }
+        catch (error) {
+            console.warn(`${logPrefix()} undelivered question answer not queued: ${error instanceof Error ? error.message : String(error)}`);
+            this.closeQuestion(workerId, askSeq, 'undeliverable', reason);
+            return;
+        }
+        this.recordUndelivered(workerId, askSeq, reason);
+        this.host.deliverConversationInput(workerId);
+    }
+    /** The answers queued for the worker's pending question that it has not taken: the parent's
+     *  replies to the routed question, and Cezar's answer when it was not delivered. */
+    queuedAnswerIds(workerId) {
+        const ask = this.context.store.transcriptFacts(workerId).pendingAsk;
+        const routedId = ask?.routedMessageId;
+        const cezar = ask ? this.undeliveredAnswerId(workerId, ask.seq) : undefined;
+        // The worker's own routing marker names the request, so a parent ledger that cannot be read
+        // hides no reply to it.
+        return (this.context.store.getRun(workerId)?.agentInputs ?? []).filter(input => !input.consumedAt &&
+            ((routedId !== undefined && input.conversation?.kind === 'reply' && input.conversation.requestId === routedId) ||
+                (input.id === cezar && input.purpose === 'undelivered-question'))).map(input => input.id);
+    }
+    /** The transcript shows the question as not delivered once, after the answer that settles it is queued. */
+    recordUndelivered(workerId, askSeq, reason) {
+        if (this.context.store.readEvents(workerId).some(event => event.type === 'worker-question-undelivered' && event.askSeq === askSeq))
+            return;
+        this.context.store.appendEvent(workerId, { type: 'worker-question-undelivered', askSeq, reason: reason ?? 'the parent could not take it' });
+    }
+    /** The worker's pending question closes unanswered (hearsay-tools/cezarion#2410), and Cezar's own
+     *  human wait for it goes. Idempotent: a question that already closed is left alone. */
+    closeQuestion(workerId, askSeq, reason, detail) {
+        if (this.context.store.transcriptFacts(workerId).pendingAsk?.seq !== askSeq)
+            return;
+        // An answer accepted for it and not yet taken goes first, so no later turn reads it as an
+        // unrelated message. A failed write leaves the question pending for the next sweep.
+        try {
+            for (const id of this.queuedAnswerIds(workerId))
+                this.host.retireUnreadParentQuestion(workerId, id);
+        }
+        catch (error) {
+            console.warn(`${logPrefix()} worker question not closed: ${error instanceof Error ? error.message : String(error)}`);
+            return;
+        }
+        if (detail)
+            this.context.store.appendEvent(workerId, { type: 'note', tone: 'warning', message: `Question not delivered to the parent: ${detail}.` });
+        this.context.store.appendEvent(workerId, { type: 'human-ask-closed', askSeq, reason });
+        this.host.withdrawCezarHumanWaits(workerId);
+        this.host.updatePendingHumanAsk(workerId, hasPendingHumanAsk(workerId, id => pendingHumanAskSeq(this.context.store, id)));
+    }
+    /**
+     * A worker parked before finishing while its parent waits on it tells the parent why
+     * (hearsay-tools/cezarion#1327): Cezar posts a progress message from the worker, which wakes the
+     * parent and closes no wait. A parked question needs none, since the question itself goes to the
+     * parent. At most one notice per parent wait (`parkNoticeId`), and none when the turn that
+     * parked already messaged the parent, Cezar's own notice included. The message and the parent's
+     * input commit together; a crash before that commit leaves the recovery sweep to post it.
+     */
+    noticeParkedWorker(workerId) {
+        const worker = this.context.store.getRun(workerId);
+        if (worker?.delegation?.role !== 'worker' || worker.delegation.destroy || !this.parkedBeforeFinishing(worker))
+            return;
+        const parentId = worker.delegation.parentRunId;
+        const root = this.context.store.getRun(parentId);
+        if (root?.delegation?.role !== 'root' || !this.parentTakesMessages(root) ||
+            !root.delegation.receipts.some(receipt => receipt.workerId === workerId && !receipt.deletion))
+            return;
+        const state = root.delegation.conversation ?? { messages: [], outcomes: [] };
+        const wait = parkNoticeWait(workerId, root.waits ?? [], state.messages);
+        if (!wait)
+            return;
+        const turn = parkingTurn(this.context.store.readEvents(workerId));
+        if (messagedParentSince(state.messages, workerId, parentId, turn.startedAt) || this.parkNoticeAtCapacity(workerId, wait.id, root, state))
+            return;
+        const now = new Date().toISOString();
+        const message = parkNoticeMessage({ workerRunId: workerId, parentRunId: parentId, waitId: wait.id, waits: worker.waits ?? [],
+            ...(turn.text === undefined ? {} : { lastText: turn.text }), now, redact: text => this.context.store.redactText(text) });
+        const input = { id: message.id, source: 'agent', parentRunId: parentId, text: message.text, createdAt: now,
+            conversation: { senderRunId: workerId, recipientRunId: parentId, kind: 'progress' } };
+        if (!commitNewMessage(this.context.store, parentId, { ...state, messages: [...state.messages, message] }, { recipientRunId: parentId, input }, () => parkNoticeIdInUse(this.context.store, workerId, wait.id)))
+            return;
+        projectConversationEvents(this.context.store, this.context.store.getRun(parentId));
+        this.host.deliverConversationInput(parentId);
+    }
+    /** A worker parked before finishing: waiting, not stopping or complete, with no pending question
+     *  and no queued input. */
+    parkedBeforeFinishing(worker) {
+        // A question goes to the parent through `routeWorkerQuestion`; a prose gate does not, so it gets a notice.
+        // Queued input wakes the worker, so the turn that takes it decides at its own park.
+        return worker.status === 'waiting' && !worker.stopping && !this.context.store.transcriptFacts(worker.id).pendingAsk &&
+            !this.host.active(worker.id)?.boundary.pendingHumanAsk && this.context.store.readWorkerExecution(worker.id)?.phase !== 'complete' &&
+            !this.host.hasQueuedAgentInputs(worker.id);
+    }
+    /** The ledger and the parent's inbox keep room as `service.send` counts it, beside open
+     *  questions' replies. When either is full, the worker's log says so once per wait. */
+    parkNoticeAtCapacity(workerId, waitId, root, state) {
+        if (state.messages.length + reservedReplies(state) < 1024 && inboxSlotsUsed(root) < 32)
+            return false;
+        const projectionId = `park-notice-skipped:${waitId}`;
+        if (!this.context.store.hasProjection(workerId, projectionId)) {
+            this.context.store.appendEvent(workerId, { type: 'note', tone: 'warning', projectionId, message: 'Parked, but the parent conversation is at capacity: no park notice was sent.' });
+        }
+        return true;
+    }
+    /** Recovery's pass over family members: a question (#505) or a park notice
+     *  (hearsay-tools/cezarion#1327) that a crash caught before or after its commit to the parent
+     *  still reaches it. The worker waits settle between the two, so a notice selects only a wait
+     *  that is still open. */
+    recoverWorkerMessages(families, familyRootId) {
+        for (const run of families)
+            if (run.delegation?.role === 'worker')
+                this.host.routeWorkerQuestion(run.id);
+        this.host.reconcileWorkerWaits(familyRootId);
+        for (const run of families)
+            this.host.noticeParkedWorker(run.id);
+    }
+    /** `noticeParkedWorker` for every worker a family's root owns. */
+    noticeParkedWorkers(rootId) {
+        for (const child of this.context.store.listWorkersOf(rootId))
+            this.host.noticeParkedWorker(child.id);
+    }
+    /** The worker's pending ask when it went to the parent (a legacy human fallback excluded). */
+    routedAsk(runId) {
+        const run = this.context.store.getRun(runId);
+        if (run?.delegation?.role !== 'worker')
+            return undefined;
+        // Indexed at append time (#880): the reconcile and every message to a worker ask this.
+        const ask = this.context.store.transcriptFacts(runId).pendingAsk;
+        if (!ask || ask.fallback || ask.routedMessageId === undefined)
+            return undefined;
+        const root = this.context.store.getRun(run.delegation.parentRunId);
+        const message = root?.delegation?.role === 'root'
+            ? root.delegation.conversation?.messages.find(entry => entry.id === ask.routedMessageId) : undefined;
+        return message ? { askSeq: ask.seq, message } : undefined;
+    }
+    /** The one reader of what answers a worker's pending question (hearsay-tools/cezarion#2410):
+     *  waking, delivering, reopening and recording an answer all read it here. */
+    pendingAnswer(runId) {
+        const routed = this.routedAsk(runId);
+        if (routed) {
+            const input = this.context.store.getRun(runId)?.agentInputs?.find(entry => !entry.deliveredAt && answersQuestion(routed.message, entry));
+            if (input)
+                return { askSeq: routed.askSeq, input, source: 'parent' };
+        }
+        // Cezar's answer stands whether or not the parent's ledger can be read again.
+        const ask = this.context.store.getRun(runId)?.delegation?.role === 'worker' ? this.context.store.transcriptFacts(runId).pendingAsk : undefined;
+        const input = ask && !ask.fallback ? this.undeliveredAnswer(runId, ask.seq) : undefined;
+        return ask && input && !input.deliveredAt ? { askSeq: ask.seq, input, source: 'cezar' } : undefined;
+    }
+    /** Who sent `input` as the answer to the worker's pending question; undefined when it is no answer. */
+    answerSource(runId, input) {
+        const routed = this.routedAsk(runId);
+        if (routed && answersQuestion(routed.message, input))
+            return 'parent';
+        const ask = this.context.store.transcriptFacts(runId).pendingAsk;
+        return ask && input.purpose === 'undelivered-question' && input.id === this.undeliveredAnswerId(runId, ask.seq) ? 'cezar' : undefined;
+    }
+    /** The worker's pending question belongs to its parent or to Cezar: no human answers it. The
+     *  worker's own routing marker decides, so a parent ledger that cannot be read hides nothing. */
+    answeredElsewhere(runId) {
+        const ask = this.context.store.getRun(runId)?.delegation?.role === 'worker' ? this.context.store.transcriptFacts(runId).pendingAsk : undefined;
+        return !!ask && !ask.fallback && ask.routedMessageId !== undefined || !!this.pendingAnswer(runId);
+    }
+    /** A routed question settled without a reply can never be answered by the parent any more: it
+     * closes (hearsay-tools/cezarion#2410). A question its worker stopped on, or a reply a stopped
+     * worker never took, closes as `worker-stopped`; one the parent's end settled closes as
+     * `parent-stopped`. A superseded fallback question closes through `supersedeWorkerFallback`. */
+    retireSettledQuestions(parentId) {
+        const root = this.context.store.getRun(parentId);
+        const conversation = root?.delegation?.role === 'root' ? root.delegation.conversation : undefined;
+        if (!conversation)
+            return;
+        // A settled parent ends the question first, an accepted reply still waiting included: it
+        // cancels its workers in the same pass.
+        const parentSettled = !['queued', 'running', 'waiting'].includes(root.status) || !!root.stopping;
+        for (const message of conversation.messages) {
+            const outcome = message.question && conversation.outcomes.find(entry => entry.requestId === message.id);
+            const reason = outcome ? this.settledQuestionClose(message.senderRunId, outcome.status, parentSettled) : undefined;
+            const routed = reason && this.routedAsk(message.senderRunId);
+            if (reason && routed && routed.message.id === message.id)
+                this.closeQuestion(message.senderRunId, routed.askSeq, reason);
+        }
+    }
+    /** Why a routed question with this outcome closes, or undefined while it still stands: a reply
+     *  waiting for a live worker answers it, one a stopped worker never took does not. */
+    settledQuestionClose(workerId, status, parentSettled) {
+        const worker = this.context.store.getRun(workerId);
+        const live = !!worker && ['queued', 'running', 'waiting'].includes(worker.status) && !worker.stopping;
+        if (live && !parentSettled && (status === 'replied' || status === 'completed-without-reply'))
+            return undefined;
+        const workerEnded = !live || status === 'sender-closed' || status === 'destroyed';
+        return workerEnded && !parentSettled ? 'worker-stopped' : 'parent-stopped';
+    }
+    /** Routed questions this parent has not answered yet, by asking worker. */
+    unansweredQuestions(parentId) {
+        return this.context.store.listWorkersOf(parentId).flatMap(run => {
+            const routed = this.routedAsk(run.id);
+            const root = this.context.store.getRun(parentId);
+            const answered = root?.delegation?.role === 'root' && root.delegation.conversation?.outcomes.some(outcome => outcome.requestId === routed?.message.id);
+            return routed && !answered ? [{ workerId: run.id, messageId: routed.message.id }] : [];
+        });
+    }
+    /** The parent settled (hearsay-tools/cezarion#2410): every open question of its workers closes
+     * with it, never moving to a human. The request outcome lands first, so a crash before the
+     * worker's close repeats this, and the close finds nothing left to do. */
+    closeRoutedQuestions(parentId) {
+        const parent = this.context.store.getRun(parentId);
+        if (parent?.delegation?.role !== 'root')
+            return;
+        const state = parent.delegation.conversation ?? { messages: [], outcomes: [] };
+        const workers = this.context.store.listWorkersOf(parentId);
+        const routed = workers.flatMap(run => { const ask = this.routedAsk(run.id); return ask ? [{ workerId: run.id, ...ask }] : []; });
+        const missing = routed.filter(entry => !state.outcomes.some(outcome => outcome.requestId === entry.message.id));
+        if (missing.length) {
+            const status = parent.status === 'failed' ? 'failed' : parent.status === 'cancelled' || parent.stopping ? 'cancelled' : 'completed-without-reply';
+            const observedAt = new Date().toISOString();
+            this.context.store.commitConversation(parentId, { ...state, outcomes: [...state.outcomes,
+                    ...missing.map(entry => ({ requestId: entry.message.id, status, observedAt }))] });
+            projectConversationEvents(this.context.store, this.context.store.getRun(parentId));
+        }
+        for (const run of workers) {
+            const ask = this.context.store.transcriptFacts(run.id).pendingAsk;
+            if (ask)
+                this.closeQuestion(run.id, ask.seq, 'parent-stopped');
+        }
+    }
+    /** The parent can still read a message from its worker. */
+    parentTakesMessages(parent) {
+        return parent.delegation?.role === 'root' && ['queued', 'running', 'waiting'].includes(parent.status) && !parent.stopping &&
+            !rootFinishRequested(this.context.store, parent.id) && !historyDeletionPending(this.context.store, parent.id);
+    }
+    /**
+     * A worker that ended a second turn with no wait or done after its no-wait nudge
+     * (hearsay-tools/cezarion#1301): Cezar's `no-wait` human wait carries one open question, raised
+     * as `ask.requested` so `routeWorkerQuestion` takes it to the parent as a request. The parent's
+     * reply resumes the worker through the answer seam, charged to the worker's budget; a parent that
+     * cannot take it closes it (hearsay-tools/cezarion#2410), and the worker parks. A full wait list
+     * opens none and the worker parks as before.
+     */
+    askParentForWorker(runId, state, stepId) {
+        const questions = [{ header: WORKER_FALLBACK_HEADER, question: WORKER_FALLBACK_QUESTION(runId) }];
+        this.context.store.appendEvent(runId, { type: 'note', ...(stepId ? { stepId } : {}), message: WORKER_FALLBACK_NOTE });
+        const wait = this.host.openHumanAlias(runId, state, 'no-wait', { questions });
+        if (wait && wait.askSeq === undefined && pendingHumanAskSeq(this.context.store, runId) === undefined) {
+            this.context.store.appendEvent(runId, { type: 'ask.requested', requestId: randomUUID(), questions, ...(stepId ? { stepId } : {}) });
+            this.host.prepareHumanAsk(state);
+            this.host.markHumanWaitSurfaced(runId, wait, { questions });
+            this.host.routeWorkerQuestion(runId);
+        }
+    }
+    /** The worker's pending question is the one `askParentForWorker` raised. */
+    isWorkerFallbackAsk(runId, askSeq) {
+        const ask = this.context.store.transcriptFacts(runId).pendingAsk;
+        const questions = ask?.seq === askSeq ? askRequestOf({ questions: ask.questions })?.questions : undefined;
+        return questions?.length === 1 && questions[0].header === WORKER_FALLBACK_HEADER && questions[0].question === WORKER_FALLBACK_QUESTION(runId);
+    }
+    /** The worker's pending question is Cezar's fallback question. */
+    pendingWorkerFallback(runId) {
+        const ask = this.context.store.transcriptFacts(runId).pendingAsk;
+        return this.context.store.getRun(runId)?.delegation?.role === 'worker' && !!ask && this.isWorkerFallbackAsk(runId, ask.seq);
+    }
+    /** The parent's reply to a worker's fallback question resumed it: one automatic wake, so a
+     *  parent and worker cannot go back and forth past the budget (hearsay-tools/cezarion#1301). */
+    chargeWorkerFallbackReply(runId, beforeHumanReset) {
+        const spent = beforeHumanReset === undefined ? this.host.chargeAutomaticWake(runId) : beforeHumanReset.spent + 1;
+        if (beforeHumanReset)
+            beforeHumanReset.spent = spent;
+        this.context.store.appendEvent(runId, { type: 'note', message: `${WORKER_FALLBACK_REPLY_NOTE} (${spent}/${this.maxAutoContinues})` });
+    }
+    /**
+     * Cezar's fallback question is Cezar's, not the worker's (hearsay-tools/cezarion#1301): what the
+     * plain park it replaced let through still goes through. A parent's input, a Continue or a closed
+     * session supersedes it: its routed request gets an outcome, so it no longer holds the parent's
+     * done, the parent's unread copy is retired, and only then does the question close unanswered
+     * (`human-ask-closed`, `superseded`) and Cezar's wait go. Each step is idempotent and the close
+     * comes last, so a failed write leaves the question pending and the next supersession, or
+     * recovery, finishes it. A question the worker asked itself is never superseded. True when it
+     * closed.
+     */
+    supersedeWorkerFallback(runId) {
+        const run = this.context.store.getRun(runId);
+        const ask = this.context.store.transcriptFacts(runId).pendingAsk;
+        if (run?.delegation?.role !== 'worker' || !ask || !this.isWorkerFallbackAsk(runId, ask.seq))
+            return false;
+        const root = this.context.store.getRun(run.delegation.parentRunId);
+        const requestId = ask.routedMessageId;
+        if (root?.delegation?.role === 'root' && requestId !== undefined) {
+            try {
+                const conversation = root.delegation.conversation;
+                if (conversation?.messages.some(message => message.id === requestId) && !conversation.outcomes.some(outcome => outcome.requestId === requestId)) {
+                    this.context.store.commitConversation(root.id, { ...conversation, outcomes: [...conversation.outcomes,
+                            { requestId, status: 'completed-without-reply', observedAt: new Date().toISOString() }] });
+                    projectConversationEvents(this.context.store, this.context.store.getRun(root.id));
+                }
+                this.host.retireUnreadParentQuestion(root.id, requestId);
+            }
+            catch (error) {
+                console.warn(`${logPrefix()} fallback question not superseded: ${error instanceof Error ? error.message : String(error)}`);
+                return false;
+            }
+        }
+        this.context.store.appendEvent(runId, { type: 'human-ask-closed', askSeq: ask.seq, reason: 'superseded' });
+        this.host.withdrawCezarHumanWaits(runId);
+        this.host.updatePendingHumanAsk(runId, hasPendingHumanAsk(runId, id => pendingHumanAskSeq(this.context.store, id)));
+        return true;
+    }
+    /** An input its run no longer owes: the parent's copy of a superseded fallback question, or a
+     *  worker's queued answer to a question that closed. One it has not read is retired, so neither a
+     *  wake nor a restart's replay of unread input delivers it. One a provider or an inbox read
+     *  already holds is left to them. */
+    retireUnreadParentQuestion(parentId, requestId) {
+        const input = this.context.store.getRun(parentId)?.agentInputs?.find(entry => entry.id === requestId);
+        if (!input || input.consumedAt || hasLiveInboxClaim(input) || this.host.providerOwnsInboxInput(parentId, requestId))
+            return;
+        this.host.deleteUnreadInput(parentId, requestId);
+        if (input.deliveredAt)
+            this.context.store.commitAgentInputsUnconfirmed(parentId, [requestId]);
+        else
+            this.context.store.commitAgentInputs(parentId, (this.context.store.getRun(parentId)?.agentInputs ?? []).filter(entry => entry.id !== requestId));
+    }
+}
+//# sourceMappingURL=worker-questions.js.map

package/dist/workflows/run/worker-questions.js.map

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

package/dist/workflows/run/workflow-position.d.ts

@@ -0,0 +1,7 @@
+/** Source reads stay at the existing workflow cursor and session-evidence call points. */
+export declare const waitingBeforeFinalWorkflowStep: (run: import("../../runs/store.ts").RunRecord, isSyntheticContinuation: (run: import("../../runs/store.ts").RunRecord, step: import("../../runs/store.ts").StepState) => boolean, waitingWorkflowStepIndex: (run: import("../../runs/store.ts").RunRecord) => number) => boolean;
+export declare const waitingWorkflowStepIndex: (run: import("../../runs/store.ts").RunRecord, isSyntheticContinuation: (run: import("../../runs/store.ts").RunRecord, step: import("../../runs/store.ts").StepState) => boolean, ciWorkflowResumeStepIndex: (run: import("../../runs/store.ts").RunRecord) => number) => number;
+export declare const continuationNextStep: (store: Pick<import("../../runs/store.ts").RunStore, 'getRun'>, runId: string, waitingWorkflowStepIndex: (run: import("../../runs/store.ts").RunRecord) => number) => import("../types.ts").WorkflowStepDef | undefined;
+export declare const ciWorkflowResumeStepIndex: (run: import("../../runs/store.ts").RunRecord) => number;
+export declare const resumableSessionId: (store: Pick<import("../../runs/store.ts").RunStore, 'getRun' | 'readEvents'>, runId: string, sessionStep: import("../../runs/store.ts").StepState | undefined) => string | undefined;
+export declare const isSyntheticContinuation: (run: import("../../runs/store.ts").RunRecord, step: import("../../runs/store.ts").StepState) => boolean;

package/dist/workflows/run/workflow-position.js

@@ -0,0 +1,9 @@
+import { atContinue } from './launch-read-resolver.js';
+/** Source reads stay at the existing workflow cursor and session-evidence call points. */
+export const waitingBeforeFinalWorkflowStep = atContinue.waitingBeforeFinalWorkflowStep;
+export const waitingWorkflowStepIndex = atContinue.waitingWorkflowStepIndex;
+export const continuationNextStep = atContinue.continuationNextStep;
+export const ciWorkflowResumeStepIndex = atContinue.ciWorkflowResumeStepIndex;
+export const resumableSessionId = atContinue.resumableSessionId;
+export const isSyntheticContinuation = atContinue.isSyntheticContinuation;
+//# sourceMappingURL=workflow-position.js.map

package/dist/workflows/run/workflow-position.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-position.js","sourceRoot":"","sources":["../../../src/workflows/run/workflow-position.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,8BAA8B,GAAG,UAAU,CAAC,8BAA8B,CAAC;AACxF,MAAM,CAAC,MAAM,wBAAwB,GAAG,UAAU,CAAC,wBAAwB,CAAC;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,UAAU,CAAC,oBAAoB,CAAC;AACpE,MAAM,CAAC,MAAM,yBAAyB,GAAG,UAAU,CAAC,yBAAyB,CAAC;AAC9E,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC,kBAAkB,CAAC;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG,UAAU,CAAC,uBAAuB,CAAC"}

package/dist/workflows/run/worktree-autosave.d.ts

@@ -0,0 +1,48 @@
+import { type AutosaveReason } from '../../git-worktree.ts';
+import type { ActiveRun } from '../active-run.ts';
+import type { RunModuleContext } from './types.ts';
+interface WorktreeAutosaveHost {
+    holdForMaintenance(runIds: readonly string[]): (() => void) | null;
+    reapTerminalScratch(runId: string): void;
+    releaseSlot(): void;
+    saveWorktree(runId: string, state: ActiveRun, reason: AutosaveReason): Promise<void>;
+    trackTurn(runId: string, task: Promise<void>): void;
+}
+/** Periodic "cezar autosave" commit in the task worktree (spec 006). */
+export declare const AUTOSAVE_INTERVAL_MS = 90000;
+/** The periodic timer is independent of idle and reply bounds. */
+export declare class AutosaveGroup {
+    #private;
+    constructor();
+    get autosaveTimer(): NodeJS.Timeout | undefined;
+    armAutosave(save: () => void): void;
+    clearAutosave(): void;
+}
+export declare function createAutosaveGroup(): AutosaveGroup;
+/**
+ * Periodic saves are opt-in. Turn-end, finalization and pre-PR flushes remain enabled; only
+ * pre-PR follows a repointed HEAD. Coalesce timer-save evidence in the handoff.
+ */
+export declare function periodicAutosaveEnabled(env?: NodeJS.ProcessEnv): boolean;
+export declare class WorktreeAutosave {
+    private readonly context;
+    private readonly host;
+    constructor(context: RunModuleContext, host: WorktreeAutosaveHost);
+    /** The save may finish execution while its strict writer proof remains pending. */
+    private readonly autosaveTasks;
+    /** Cleanup evidence survives manager disposal and store close/reopen. */
+    autosaveCleanupBlocker(runId: string): string | undefined;
+    /** Keep a separate maintenance hold until autosave proves all its processes exited.
+     *  Commits only while HEAD is the run's recorded branch (hearsay-tools/cezarion#1004), and
+     *  records a commit or a skip in the run store, shown in the handoff's records block, and as a
+     *  note; a periodic save records only a commit, with no note, merged with the
+     *  periodic commits right before it. A run with no recorded branch keeps committing on
+     *  whatever HEAD is. */
+    saveWorktree(runId: string, state: ActiveRun, reason: AutosaveReason): Promise<void>;
+    private saveWorktreeWork;
+    /** Autosave-commit the worktree every 90 s while the run lives (spec 006).
+     *  Opt-in via CEZ_AUTOSAVE=1 (open-mercato/cezar#471) — see periodicAutosaveEnabled. */
+    armAutosave(runId: string, state: ActiveRun): void;
+    dispose(): void;
+}
+export {};