import type { CheckpointId } from '../../types/ids/index.js';
import type { Checkpoint } from '../../types/session/checkpoint.js';
import type { CheckpointLogView, CheckpointScope } from './contract.js';
/** What choosing checkpoints to prune needs to know about each one. */
export type PrunableSessionCheckpoint = Pick<Checkpoint, 'checkpointId' | 'createdAt'>;
/**
 * The checkpoints to delete so that `keepLast` newer ones remain.
 *
 * Salvaged from the run-era `selectCheckpointsToPrune`: the candidates are the
 * oldest `all.length - keepLast`, which keeps the newest `keepLast` (the
 * turn's resume point) out of reach, and a protected checkpoint among them is
 * skipped rather than counted.
 *
 * A checkpoint is protected when an open decision references it. The run-era
 * document carried its own `pending` park; a session checkpoint carries none,
 * because the question lives in the log as a `decision_requested` record with
 * no `decision_resolved` or `decision_expired` after it. Deleting the
 * checkpoint such a record names would leave a question somebody may be in
 * the middle of answering with nothing to resume from. An expired decision is
 * closed by its own record, so it protects nothing.
 *
 * Order is `createdAt`, then `checkpointId`: ids are UUIDv7, so the tiebreak
 * is also chronological within one millisecond, and the order is total.
 *
 * @throws RangeError when `keepLast` is not a nonnegative safe integer.
 */
export declare function selectSessionCheckpointsToPrune(checkpoints: readonly PrunableSessionCheckpoint[], keepLast: number, protectedIds?: ReadonlySet<CheckpointId>): CheckpointId[];
/** Oldest first: `createdAt`, then `checkpointId`. Shared by every store's `list`. */
export declare function compareCheckpoints(left: PrunableSessionCheckpoint, right: PrunableSessionCheckpoint): number;
/**
 * The checkpoints `prune(scope, keepLast)` deletes, from the turn's stored
 * documents: shared by every store so they choose alike.
 *
 * Only a committed checkpoint, one a `checkpoint_written` record names, is
 * ranked. A document with no such record is inert by design (writes are
 * unfenced: a stale writer, or a crash between the write and the append,
 * leaves one behind) and a restore refuses it as `not-recorded`. Counting it
 * toward `keepLast` would let it stand in for the turn's real resume point
 * and prune that instead. It is not deleted either: the writer that holds
 * the lease may be between its write and its append, and the id would go
 * into a `checkpoint_pruned` record that names a checkpoint no record ever
 * committed.
 */
export declare function selectStoredCheckpointsToPrune(log: CheckpointLogView, scope: CheckpointScope, stored: readonly Checkpoint[], keepLast: number): Promise<CheckpointId[]>;
//# sourceMappingURL=prune.d.ts.map