import type { Digest, HeldoutApproval, HeldoutAttempt, HeldoutBundle, HeldoutEvent } from './types.js'; export declare const heldoutRunsRoot: (root: string) => string; /** Caller holds the global dispatch lock. Never rewrite or refund a counter entry. */ export declare function appendHeldoutSpend(root: string, attempt: HeldoutAttempt): Promise; /** Called under the global dispatch lock, after checking existing journals. Floors and study budgets are recorded once. */ export declare function reconcileHeldoutBaseline(root: string, approval: HeldoutApproval): Promise<{ study: Digest; portfolio: Digest; }>; /** Reject symlinked journal ancestors as well as leaves: spend cannot be redirected to another root. */ export declare function heldoutDirectory(path: string): Promise; export declare function writeHeldoutFile(path: string, value: unknown): Promise; export declare function readHeldoutFile(path: string): Promise; export declare function readHeldoutJournal(run: string): Promise; export declare function appendHeldoutEvent(run: string, events: HeldoutEvent[], attempt: HeldoutAttempt): Promise; export interface HeldoutPriorRun { runId: string; evidenceDigest: Digest; corpusDigest: Digest; study: string; source: 'injected-transport' | 'provider'; } export declare function heldoutEvidenceDigest(run: string, events: HeldoutEvent[]): Promise; export interface HeldoutScan { studyUsdMicros: number; portfolioUsdMicros: number; studyCalls: number; studyReservedTokens: number; counterBlocked: boolean; attempts: HeldoutAttempt[]; journalDigests: Digest[]; runs: HeldoutPriorRun[]; } /** Count reservations, including crashes and failed requests; successful small usage never refunds spend. */ export declare function scanHeldoutSpend(root: string, study: string, approval?: HeldoutApproval): Promise; /** Replay enforces the same membership, phase and reservation pins as dispatch. */ export declare function validateHeldoutJournal(bundle: HeldoutBundle, events: readonly HeldoutEvent[]): Promise; /** Every mode shares fixed thresholds; admission checks the approval against its durable study baseline. */ export declare function heldoutCollectionAllowance(approval: HeldoutApproval, prior: HeldoutScan): { calls: number; tokens: number; usdMicros: number; }; //# sourceMappingURL=journal.d.ts.map