export interface CacheBenchmarkSample { mode: 'cache-disabled' | 'cache-enabled'; preparationLatencyMs: number; inputTokens: number | null; /** Authoritative provider output tokens; absent means total task tokens are unknown. */ outputTokens?: number | null; cachedInputTokens: number | null; costUsd: number | null; memoryBytes: number; storageBytes: number; outcome: 'hit' | 'miss' | 'bypass' | 'unknown'; invalidated: boolean; } export interface CacheBenchmarkReport { schemaVersion: 'decision-cache-benchmark/v1'; configurationDigest: `sha256:${string}`; warmupCalls: number; measuredCalls: number; minimumBenefitTargetBps: number; confidenceInterval: string; disabled: ReturnType; enabled: ReturnType; } export declare function cacheBenchmarkReport(configurationDigest: `sha256:${string}`, warmupCalls: number, minimumBenefitTargetBps: number, confidenceInterval: string, samples: CacheBenchmarkSample[]): CacheBenchmarkReport; export interface CacheBenchmarkTargetResult { metric: 'preparation-latency'; targetBps: number; /** Relative latency reduction of enabled over disabled; null when the baseline cannot support a ratio. */ observedBenefitBps: number | null; outcome: 'pass' | 'fail' | 'unknown'; } /** * Enforce the preregistered minimum benefit as a pass/fail result. Only * measured preparation latency is judged; unknown provider economics never * contribute to a pass. */ export declare function evaluateCacheBenchmarkTarget(report: CacheBenchmarkReport): CacheBenchmarkTargetResult; /** Deterministic paired bootstrap interval; positive differences favor enabled caching. */ export declare function pairedPreparationLatencyInterval(disabled: readonly number[], enabled: readonly number[], iterations?: number): string; declare function summarize(samples: CacheBenchmarkSample[]): { calls: number; averagePreparationLatencyMs: number; averageInputTokens: number | null; averageTotalTaskTokens: number | null; averageCachedInputTokens: number | null; averageCostUsd: number | null; peakMemoryBytes: number; peakStorageBytes: number; hitRateBps: number; invalidationRateBps: number; }; export {}; //# sourceMappingURL=benchmark.d.ts.map