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

package/dist/workflows/run/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/workflows/run/constants.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,MAAM,CAAC;AAE3C,0FAA0F;AAC1F,MAAM,CAAC,MAAM,uBAAuB,GAAG,6DAA6D,CAAC;AAErG;8EAC8E;AAC9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAE5C;;sGAEsG;AACtG,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAG,MAAM,CAAC;AAEjD;;0CAE0C;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,6IAA6I,CAAC;AAElL,8EAA8E;AAC9E,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,uFAAuF;AACvF,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,wCAAwC,0BAA0B,yCAAyC,CAAC;AAClJ,mFAAmF;AACnF,MAAM,CAAC,MAAM,yBAAyB,GAAG,2DAA2D,CAAC;AACrG,4FAA4F;AAC5F,MAAM,CAAC,MAAM,oBAAoB,GAAG,kFAAkF,CAAC;AACvH,8FAA8F;AAC9F,MAAM,CAAC,MAAM,sBAAsB,GAAG,mFAAmF,CAAC;AAE1H;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAExC;mGACmG;AACnG,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAE1C,MAAM,CAAC,MAAM,2BAA2B,GACtC,2MAA2M,CAAC"}

package/dist/workflows/run/continuation-acceptance.d.ts

@@ -0,0 +1,70 @@
+import type { RunnerId } from '../../core/agent-runner.ts';
+import type { WorkerStepIdentity } from '../../delegation/execution-identity.ts';
+import type { RunRecord, RunStore, StepState } from '../../runs/store.ts';
+import * as continuation from '../continuation-admission.ts';
+import type { ContinueRunOptions } from '../continuation-admission.ts';
+import type { RunExitId } from '../../runs/run-exits.ts';
+import { type PastedContent } from '../pasted-content.ts';
+import type { WorkflowDef } from '../types.ts';
+import type { RunModuleContext, StartRunInput } from './types.ts';
+import type { MaintenanceClaims } from './maintenance-claims.ts';
+import type { RunLine } from './run-line.ts';
+import type { WorkerExecutions } from './worker-executions.ts';
+import type { QueuedInput } from './queued-input.ts';
+import type { AutoResumeScheduler } from './auto-resume.ts';
+import type { WorktreeAutosave } from './worktree-autosave.ts';
+import type { WorkerQuestions } from './worker-questions.ts';
+interface ContinuationAcceptanceHost {
+    isActive(runId: string): boolean;
+    move(id: string, exit: RunExitId, patch?: Omit<Parameters<RunStore['updateRun']>[1], 'status'>): RunRecord | undefined;
+    ownedJob(run: RunRecord): {
+        workflow: WorkflowDef;
+        input: StartRunInput;
+    };
+    executionBlockedByRootFinish(run: RunRecord): boolean;
+    finishWorkerExecution(runId: string): Promise<void>;
+    clearWakeBackoff(runId: string): void;
+    dropActive(runId: string): void;
+    pump(): Promise<void>;
+    runContinuation(runId: string, stepId: string, sessionId: string | undefined, backend: RunnerId, prompt: string, images: PastedContent[]): Promise<void>;
+    workerStep(runId: string, stepId: string | undefined): WorkerStepIdentity | undefined;
+    isUntouchedCancelledRun(run: RunRecord): boolean;
+    admissionError(error: unknown, fallback: string): string;
+    isSyntheticContinuation(run: RunRecord, step: StepState): boolean;
+}
+export declare class ContinuationAcceptance {
+    private readonly context;
+    private readonly host;
+    private readonly claims;
+    private readonly line;
+    private readonly workerExecutions;
+    private readonly queuedInput;
+    private readonly autoResumeScheduler;
+    private readonly worktreeAutosave;
+    private readonly workerQuestions;
+    private readonly routedQuestionRefusal;
+    private readonly restartContinuationPrompt;
+    constructor(context: RunModuleContext, host: ContinuationAcceptanceHost, claims: MaintenanceClaims, line: RunLine, workerExecutions: WorkerExecutions, queuedInput: QueuedInput, autoResumeScheduler: AutoResumeScheduler, worktreeAutosave: WorktreeAutosave, workerQuestions: WorkerQuestions, routedQuestionRefusal: string, restartContinuationPrompt: string);
+    /** Accepted Continues supersede in-flight settlement even before launch or after
+     * idle close. Retain these across dropActive/dispose so absence cannot look like
+     * the earlier execution again; disposal alone never revokes terminal intent. */
+    private readonly continuationGenerations;
+    generation(runId: string): symbol | undefined;
+    /** Saves an accepted continuation. A human Continue also answers every human wait, ends failed
+     *  deliveries and restarts the budget, in the same best-effort commit. */
+    private commitContinuation;
+    admitContinuation(runId: string, opts: ContinueRunOptions, deferForCapacity: boolean, conversation: continuation.ContinuationConversation): {
+        ok: boolean;
+        error?: string;
+    };
+    /** Overrides still persist before the execution checkpoint, even if that checkpoint refuses. */
+    private acceptContinuation;
+    private acceptUntouchedContinuation;
+    private acceptResumedContinuation;
+    private checkpointContinuation;
+    private dispatchAcceptedContinuation;
+    /** A Continue whose engine threw: the run fails and leaves the active set (exit `fail-crash`). */
+    failCrashedContinuation(runId: string, err: unknown): void;
+    private waitingWorkflowStepIndex;
+}
+export {};

package/dist/workflows/run/continuation-acceptance.js

@@ -0,0 +1,188 @@
+import { atContinue, atTaskHead } from './launch-read-resolver.js';
+import { isUsageLimitHold } from '../../contract/index.js';
+import * as continuation from '../continuation-admission.js';
+import { contentBlocksOf } from '../pasted-content.js';
+import { historyDeletionPending } from './run-guards.js';
+import * as workflowPosition from './workflow-position.js';
+import { hasPendingHumanAsk, pendingHumanAskSeq } from './pending-ask-facts.js';
+export class ContinuationAcceptance {
+    context;
+    host;
+    claims;
+    line;
+    workerExecutions;
+    queuedInput;
+    autoResumeScheduler;
+    worktreeAutosave;
+    workerQuestions;
+    routedQuestionRefusal;
+    restartContinuationPrompt;
+    constructor(context, host, claims, line, workerExecutions, queuedInput, autoResumeScheduler, worktreeAutosave, workerQuestions, routedQuestionRefusal, restartContinuationPrompt) {
+        this.context = context;
+        this.host = host;
+        this.claims = claims;
+        this.line = line;
+        this.workerExecutions = workerExecutions;
+        this.queuedInput = queuedInput;
+        this.autoResumeScheduler = autoResumeScheduler;
+        this.worktreeAutosave = worktreeAutosave;
+        this.workerQuestions = workerQuestions;
+        this.routedQuestionRefusal = routedQuestionRefusal;
+        this.restartContinuationPrompt = restartContinuationPrompt;
+    }
+    /** Accepted Continues supersede in-flight settlement even before launch or after
+     * idle close. Retain these across dropActive/dispose so absence cannot look like
+     * the earlier execution again; disposal alone never revokes terminal intent. */
+    continuationGenerations = new Map();
+    generation(runId) { return this.continuationGenerations.get(runId); }
+    /** Saves an accepted continuation. A human Continue also answers every human wait, ends failed
+     *  deliveries and restarts the budget, in the same best-effort commit. */
+    commitContinuation(runId, human) {
+        const outcomes = [{ kind: 'answered' }, { kind: 'counted', waitDeliveryFailures: undefined },
+            ...(this.context.store.getRun(runId)?.automaticWakes ? [{ kind: 'charged', automaticWakes: 0 }] : [])];
+        if (!human || !this.context.store.commitOutcome(runId, outcomes, {}, { bestEffort: true }).committed)
+            this.context.store.flush();
+    }
+    admitContinuation(runId, opts, deferForCapacity, conversation) {
+        const admitted = new continuation.ContinuationChecks(runId, this.context.repoRoot, opts, deferForCapacity, conversation, {
+            active: () => this.host.isActive(runId),
+            autosaveBlocker: () => this.worktreeAutosave.autosaveCleanupBlocker(runId),
+            reclaiming: () => this.claims.has(runId),
+            run: () => this.context.store.getRun(runId),
+            historyDeletionPending: () => historyDeletionPending(this.context.store, runId),
+            parentStatus: parentId => this.context.store.getRun(parentId)?.status,
+            identity: (run, session) => this.host.workerStep(runId, atContinue.definitionId(atContinue.definitionStep(this.context.store, run, session))),
+            beforeFinalStep: run => workflowPosition.waitingBeforeFinalWorkflowStep(run, (record, step) => this.host.isSyntheticContinuation(record, step), record => this.waitingWorkflowStepIndex(record)),
+            waitingStepIndex: run => this.waitingWorkflowStepIndex(run),
+            pendingFallback: () => this.workerQuestions.pendingWorkerFallback(runId),
+            pendingAsk: () => hasPendingHumanAsk(runId, id => pendingHumanAskSeq(this.context.store, id)),
+            rootFinishing: run => this.host.executionBlockedByRootFinish(run),
+            answeredElsewhere: () => this.workerQuestions.answeredElsewhere(runId),
+            ciStepIndex: run => workflowPosition.ciWorkflowResumeStepIndex(run),
+            untouched: run => this.host.isUntouchedCancelledRun(run),
+            sessionId: step => workflowPosition.resumableSessionId(this.context.store, runId, step),
+        }, this.routedQuestionRefusal, this.context.home).prepare();
+        if (!admitted.ok)
+            return admitted;
+        return this.acceptContinuation(runId, opts, deferForCapacity, conversation, admitted);
+    }
+    /** Overrides still persist before the execution checkpoint, even if that checkpoint refuses. */
+    acceptContinuation(runId, opts, deferForCapacity, conversation, admitted) {
+        if (admitted.identity === undefined && continuation.hasOverrides(opts)) {
+            const refusal = continuation.modelRefusal(opts, admitted.targetRunner);
+            if (refusal)
+                return refusal;
+            this.context.store.updateRun(runId, continuation.overridePatch(admitted.run, opts, admitted.targetRunner, admitted.originalRunner));
+        }
+        if (admitted.untouched)
+            return this.acceptUntouchedContinuation(runId, opts, admitted.supersedes);
+        return this.acceptResumedContinuation(runId, opts, deferForCapacity, conversation, admitted);
+    }
+    acceptUntouchedContinuation(runId, opts, supersedes) {
+        const current = this.context.store.getRun(runId);
+        let job;
+        try {
+            job = current.delegation?.role === 'worker'
+                // A projection of the job the line will start, not a status write.
+                ? this.host.ownedJob({ ...current, status: 'queued' })
+                : { workflow: atContinue.storedWorkflow(current), input: atTaskHead.recoveryInput(current) };
+            this.workerExecutions.beginWorkerExecution(runId, false);
+        }
+        catch (error) {
+            return { ok: false, error: this.host.admissionError(error, 'original execution checkpoint unavailable') };
+        }
+        if (supersedes)
+            this.workerQuestions.supersedeWorkerFallback(runId);
+        const content = continuation.content(opts);
+        const message = content.length ? this.queuedInput.toQueuedMessage(runId, content) : undefined;
+        this.autoResumeScheduler.clearAutoResume(runId);
+        this.context.store.setArchived(runId, false);
+        this.host.move(runId, 'continue-line', { stopping: undefined,
+            ...(message ? { queuedMessages: [...(current.queuedMessages ?? []), message] } : {}) });
+        this.context.store.flush();
+        this.line.enqueueJob(runId, job);
+        void this.host.pump();
+        return { ok: true };
+    }
+    acceptResumedContinuation(runId, opts, deferForCapacity, conversation, admitted) {
+        const { run, supersedes } = admitted;
+        // Usage-limit holds join the line even for a human Continue, behind known account deadlines.
+        const toLine = deferForCapacity || isUsageLimitHold(run);
+        try {
+            this.workerExecutions.beginWorkerExecution(runId, !toLine);
+        }
+        catch (error) {
+            return { ok: false, error: this.host.admissionError(error, 'worker execution checkpoint unavailable') };
+        }
+        this.autoResumeScheduler.clearAutoResume(runId);
+        if (!deferForCapacity)
+            this.host.clearWakeBackoff(runId);
+        const failure = continuation.previousFailure(run);
+        const continuationStep = continuation.nextStep(run);
+        const stepId = continuationStep.id;
+        if (run.delegation?.role !== 'worker')
+            this.context.store.addStep(runId, continuationStep);
+        const recovered = deferForCapacity && !conversation && !opts.answerInputId ? atContinue.checkpoint(run) : undefined;
+        const message = recovered ?? this.queuedInput.toQueuedMessage(runId, continuation.content(opts));
+        const { prompt, resumeContext } = continuation.opening(message, recovered, deferForCapacity, conversation, opts, this.restartContinuationPrompt, failure);
+        // The recoverable status and original input must commit before startup can await anything.
+        const acceptedPatch = {
+            continuationMessage: continuation.acceptedMessage(message, stepId, prompt, resumeContext, recovered, conversation, opts, deferForCapacity),
+            ...(toLine ? {} : { currentStepId: stepId }),
+            invalidAsk: undefined,
+            archived: false,
+            archivedAt: undefined,
+        };
+        const refusal = this.checkpointContinuation(runId, run, toLine ? 'continue-line' : 'continue-now', acceptedPatch, continuationStep, conversation);
+        if (refusal)
+            return refusal;
+        if (supersedes)
+            this.workerQuestions.supersedeWorkerFallback(runId);
+        // Resolve waits/restart budgets only with or after the dependent answer (hearsay-tools/cezarion#1805).
+        this.commitContinuation(runId, !deferForCapacity);
+        this.continuationGenerations.set(runId, Symbol());
+        const images = contentBlocksOf(opts.images ?? []).filter(block => block.type === 'image');
+        return this.dispatchAcceptedContinuation(runId, toLine, stepId, admitted.resumeSessionId, admitted.targetRunner, prompt, images);
+    }
+    checkpointContinuation(runId, run, exit, acceptedPatch, continuationStep, conversation) {
+        if (run.delegation?.role === 'worker') {
+            try {
+                this.context.store.commitWorkerContinuation(runId, exit, acceptedPatch, continuationStep, conversation);
+            }
+            catch {
+                // No session exists yet. Release the private reservation through execution finalization.
+                void this.host.finishWorkerExecution(runId);
+                return { ok: false, error: 'worker execution checkpoint unavailable' };
+            }
+        }
+        else
+            this.context.store.move(runId, exit, acceptedPatch);
+    }
+    dispatchAcceptedContinuation(runId, toLine, stepId, resumeSessionId, targetRunner, prompt, images) {
+        if (toLine) {
+            this.line.enqueueContinuation(runId, {
+                stepId, sessionId: resumeSessionId, backend: targetRunner, prompt, images, lineJoinedAt: Date.now(),
+            });
+            // `checkpointContinuation` already wrote continue-line (Table B7).
+            // Enqueueing wakes the scheduler even after the previous execution released its slot.
+            void this.host.pump();
+            return { ok: true };
+        }
+        this.line.markStarting(runId);
+        void this.context.work.track('runContinuation', this.host.runContinuation(runId, stepId, resumeSessionId, targetRunner, prompt, images))
+            .catch((err) => this.failCrashedContinuation(runId, err))
+            .finally(() => this.host.finishWorkerExecution(runId));
+        return { ok: true };
+    }
+    /** A Continue whose engine threw: the run fails and leaves the active set (exit `fail-crash`). */
+    failCrashedContinuation(runId, err) {
+        const message = err instanceof Error ? err.message : String(err);
+        this.host.move(runId, 'fail-crash', { error: `continue crashed: ${message}` });
+        this.line.unmarkStarting(runId);
+        this.host.dropActive(runId);
+    }
+    waitingWorkflowStepIndex(run) {
+        return workflowPosition.waitingWorkflowStepIndex(run, (record, step) => this.host.isSyntheticContinuation(record, step), workflowPosition.ciWorkflowResumeStepIndex);
+    }
+}
+//# sourceMappingURL=continuation-acceptance.js.map

package/dist/workflows/run/continuation-acceptance.js.map

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

package/dist/workflows/run/continuation-session.d.ts

@@ -0,0 +1,130 @@
+import type { QueuedInput } from './queued-input.ts';
+import type { WorkerQuestions } from './worker-questions.ts';
+import type { ContentBlock } from '../../core/agent-runner.ts';
+import { type PastedContent, type PersistedAttachment } from '../pasted-content.ts';
+import type { AutosaveReason } from '../../git-worktree.ts';
+import * as inputReceipts from './input-receipts.ts';
+import type { HumanWaits } from './human-waits.ts';
+import type { RunSettlement } from './run-settlement.ts';
+import type { AgentSession, RunnerId } from '../../core/agent-runner.ts';
+import type { WorkerStepIdentity } from '../../delegation/execution-identity.ts';
+import type { CezConfig } from '../../config.ts';
+import type { ActiveRun } from '../active-run.ts';
+import type { UiEventSink } from '../../runs/ui-event-sink.ts';
+import type { RepoRootLease } from './repo-root-lease.ts';
+import type { WorktreeAutosave } from './worktree-autosave.ts';
+import type { RunSkills } from './run-skills.ts';
+import * as sessionEvents from './session-events.ts';
+import type { PendingContinuation } from './types.ts';
+import type { RunRecord, StepState } from '../../runs/store.ts';
+import type { RunExitId, RunPatch } from '../../runs/run-exits.ts';
+import type { RunLine } from './run-line.ts';
+import type { RunModuleContext } from './types.ts';
+export interface ContinuationSessionHost {
+    move(runId: string, exit: RunExitId, patch?: RunPatch): void;
+    dropActive(runId: string): void;
+    repositoryRootLockDisabled(): boolean;
+    beginUsageInvocation(runId: string, state: ActiveRun, stepId: string): void;
+    trackWorkerSessionResult(runId: string, session: AgentSession): Promise<void>;
+    recordUsagePeaks(runId: string): void;
+    saveWorktree(runId: string, state: ActiveRun, reason: AutosaveReason): Promise<void>;
+    pump(): Promise<void>;
+    isSyntheticContinuation(run: RunRecord, step: StepState): boolean;
+    makeUiSink(runId: string, stepId: string): UiEventSink;
+    prepareWorktree(runId: string, state: ActiveRun, config: CezConfig['worktreeSetup'], emit: (event: {
+        type: string;
+        [key: string]: unknown;
+    }) => void, reason: 'rematerialized' | 'resume'): Promise<string | undefined>;
+    workerStep(runId: string, stepId: string | undefined): WorkerStepIdentity | undefined;
+    latchAgentInputError(runId: string, state: ActiveRun, session: AgentSession, message: string): void;
+    reconcileWorkerWaits(): void;
+    holdContinuationForRootFinish(runId: string, item: PendingContinuation, state?: ActiveRun): boolean;
+}
+/** Owns the Continue workspace and launch session. */
+export declare class ContinuationSession {
+    private readonly context;
+    private readonly host;
+    private readonly line;
+    private readonly sharedHost;
+    private readonly repoRootLease;
+    private readonly autosave;
+    private readonly runSkills;
+    private readonly sessionEventHost;
+    private readonly launchPreambleHost;
+    private readonly inputReceiptHost;
+    private readonly inputReceiptSteps;
+    private readonly humanWaits;
+    private readonly queuedInput;
+    private readonly workerQuestions;
+    private readonly runSettlement;
+    constructor(context: RunModuleContext, host: ContinuationSessionHost, line: RunLine, sharedHost: sessionEvents.SessionHelperHost, repoRootLease: RepoRootLease, autosave: WorktreeAutosave, runSkills: RunSkills, sessionEventHost: sessionEvents.SessionEventHost, launchPreambleHost: sessionEvents.LaunchPreambleHost, inputReceiptHost: inputReceipts.InputReceiptsHost, inputReceiptSteps: inputReceipts.InputReceiptSteps, humanWaits: HumanWaits, queuedInput: QueuedInput, workerQuestions: WorkerQuestions, runSettlement: RunSettlement);
+    /** Where a Continue runs: an owned worker's verified workspace, or the task's worktree, which
+     *  retention may have reclaimed (#483), else the repository root. Returns undefined after an
+     *  unavailable owned workspace failed the run. */
+    continuationWorkspace(runId: string, stepId: string, record: RunRecord | undefined): Promise<{
+        cwd: string;
+        rematerialized: boolean;
+    } | undefined>;
+    /** An owned worker's workspace for a Continue, verified with its parent's context. Returns
+     *  undefined after it failed the run: owned workers never adopt or recreate an unverified resource. */
+    private ownedContinuationWorkspace;
+    private failWorkspace;
+    /** A Stop that arrived while the Continue resolved its workspace cancels the run before it
+     *  becomes active. */
+    settleStoppedContinuation(runId: string): boolean;
+    /** The repository-root lease of a Continue that runs in the repository root. Returns undefined
+     *  when no lease is needed, so that path does not yield, else whether the lease was granted. */
+    private continuationRepoRootLease;
+    /** Wait for the repository-root lease; a Stop during the wait cancels the run. */
+    private acquireContinuationRepoRoot;
+    /** Arm autosave, seed the handoff file, and run worktree setup. Returns setup's note for the
+     *  opening message. */
+    private prepareContinuationWorktree;
+    /** Mark the run and the Continue's step as running, then open the step. A Cursor session resumes
+     *  on the transport it was opened with; the runner refuses an ACP one (hearsay-tools/cezarion#1267). */
+    private startContinuationStep;
+    /** The human ask a human Continue answers, and the human waits that answer settles. */
+    private openingAnswer;
+    /**
+     * A completed turn acknowledges the opening payload. Until then a restart
+     * must replay it, including a crash after startSession but before delivery.
+     * Returns false when the opening input's checkpoint failed, and the turn end stops there.
+     */
+    private acknowledgeOpeningTurn;
+    /**
+     * What a Continue runs with. Backend + model come off the record: the run's current backend by
+     * default, or the follow-up override that `continueRun` persisted before scheduling (#401).
+     * Returns undefined after a pre-spawn gate failed the turn.
+     */
+    private continuationLaunchSettings;
+    /** Settle this turn as a failure before anything is spawned — the shape every
+     *  pre-spawn gate needs (model identity, #405; temp directory, #785). */
+    private failContinuationBeforeSpawn;
+    /** Record the Continue's account on its step and the settings its workers inherit. */
+    private applyContinuationSettings;
+    /** The continued step's skill files and playbook, when the step names a skill or the prompt
+     *  starts with a `/name`. Returns undefined otherwise, so that path does not yield. */
+    private continuationSkills;
+    /** Reinstall the continued step's skill and a leading `/name`'s, and build the playbook. */
+    private provisionContinuationSkills;
+    /** The continued step's skill when the registry did not list it yet. */
+    private awaitContinuedSkill;
+    /** A Stop before the Continue's session spawned: cancel the step and the run. */
+    private settleContinuationPrelaunchCancel;
+    /** A Continue's launch went stale while it provisioned (`launchStale`). A replaced active run
+     *  needs nothing more; a Stop cancels the run; a root Finish holds the Continue in the queue. */
+    private settleStaleContinuationLaunch;
+    /** Launch the active Continue after its facade has pinned it and left the starting set. */
+    launchContinuation(runId: string, stepId: string, sessionId: string | undefined, backend: RunnerId, prompt: string, images: PastedContent[], persistedImages: ContentBlock[], persistedAttachments: PersistedAttachment[], state: ActiveRun, record: RunRecord | undefined, rematerialized: boolean): Promise<void>;
+    /** Start a Continue's session, resuming its own session when it has one. A throw revokes the
+     *  tools this launch was given and propagates to `continueRun`. */
+    private startContinuationSession;
+    /** Wait for a Continue's session to close, then settle the run by how it closed. Teardown always
+     *  revokes the launch's tools, saves the worktree and leaves the active set
+     *  (`releaseContinuationSession`). */
+    private awaitContinuationSession;
+    /** A Continue's session teardown: revoke the launch's tools, record the usage peaks, clear the
+     *  timers, save the worktree, leave the active set, then queue the workflow remainder. */
+    private releaseContinuationSession;
+}
+export declare function staleContinuationDisposition(current: ActiveRun | undefined, state: ActiveRun, workerStopped: () => boolean): 'replaced' | 'cancel' | 'hold';