export type RecordReferenceResolution = 'found' | 'not-found' | 'unknown';
export interface DefaultRecordReferenceResolverOptions {
    /**
     * Optional wall-clock budget for local mirror scanning. When exceeded, log
     * lookup may still prove the record exists, but a miss is reported as
     * `unknown` because local evidence was not fully searched.
     */
    localLookupTimeoutMs?: number | undefined;
    /** Optional wall-clock budget for public log lookup. Defaults to 750ms. */
    logLookupTimeoutMs?: number | undefined;
    /**
     * Explicit local mirror files for this lookup. When present, these replace
     * process-global mirror discovery while public log fallback stays enabled.
     */
    localMirrorPaths?: readonly string[] | undefined;
}
export type LocalRecordReferenceResolver = (recordHash: string) => RecordReferenceResolution | Promise<RecordReferenceResolution>;
/**
 * Resolve a record_hash against local mirrors first, then the public log.
 *
 * `found` means the producer has enough evidence to keep an `informed_by`
 * edge. `not-found` means lookup succeeded and the ref is absent. `unknown`
 * means the validation substrate failed, so callers that require validated
 * refs should drop the candidate without blocking the wrapped tool call.
 */
export declare function defaultRecordReferenceResolver(recordHash: string, logEndpoint?: string | undefined, options?: DefaultRecordReferenceResolverOptions): Promise<RecordReferenceResolution>;
export declare function clearRecordReferenceResolverCacheForTests(): void;
export declare function recordReferenceResolverCacheStatsForTests(): {
    cached_file_count: number;
    cached_record_hash_count: number;
    full_file_scans: number;
    append_file_scans: number;
    reused_file_caches: number;
};
//# sourceMappingURL=record-reference.d.ts.map