import type { ReceiptEnvelope } from "./receipts";
export declare const RECEIPT_SPOOL_DIR_ENV = "GJC_RECEIPT_SPOOL_DIR";
export declare const RECEIPT_SPOOL_FILENAME = "spool.jsonl";
export declare const RECEIPT_SPOOL_CURSOR_WIDTH = 12;
export interface ReceiptSpoolRecord {
    cursor: string;
    envelope: ReceiptEnvelope<unknown>;
}
export interface ReceiptSpoolAppendResult {
    cursor: string;
    path: string;
}
/** @internal Test-only instrumentation for steady-state spool scan coverage. */
export declare function receiptSpoolFullScanCountForTesting(): number;
/** @internal Test-only cache reset. */
export declare function resetReceiptSpoolCursorCacheForTesting(): void;
export declare function withReceiptSpoolDir<T>(spoolDir: string, fn: () => Promise<T>): Promise<T>;
export declare function resolveReceiptSpoolDir(env?: NodeJS.ProcessEnv): string | undefined;
export declare function receiptSpoolPath(spoolDir: string): string;
export declare function formatReceiptSpoolCursor(cursor: bigint): string;
export declare function readHighestReceiptSpoolCursor(spoolDir: string): Promise<bigint>;
export declare function appendReceiptToSpool(spoolDir: string, envelope: ReceiptEnvelope<unknown>): Promise<ReceiptSpoolAppendResult>;
export declare function appendReceiptToConfiguredSpool(envelope: ReceiptEnvelope<unknown>, env?: NodeJS.ProcessEnv): Promise<ReceiptSpoolAppendResult | undefined>;