/**
 * Extended Benchmark Harness
 *
 * Provides percentile calculation utilities and named benchmark runners for
 * each major Nexus Prime engine. Results include p50/p95/p99 latency, throughput,
 * and peak RSS — shaped to match the investor benchmark report format.
 *
 * Market comparison baselines (from docs/investor/benchmark-report.md):
 *   Memory store:   Mem0 cloud ~50-200ms,  Zep ~30-100ms  → target: < 5ms
 *   Memory recall:  Zep vector ~30-100ms               → target: < 10ms
 *   Token ratio:    naive 1x, vLLM prefix ~2x           → target: ≥ 2x
 *   N-gram query:   full-scan ~O(N)                     → target: < 5ms
 *   Knowledge fab:  no direct competitor                → target: < 50ms
 *   Dashboard API:  –                                   → p95 < 300ms
 */
export interface ExtendedBenchmarkResult {
    name: string;
    /** Latency percentiles in milliseconds */
    p50: number;
    p95: number;
    p99: number;
    /** Operations per second */
    throughputPerSec: number;
    /** Peak process RSS in bytes at end of run */
    peakRssBytes: number;
    /** Number of iterations actually executed */
    iterations: number;
    /** Arbitrary extra data (ratios, counts, etc.) */
    extra?: Record<string, number | string>;
}
export declare function percentile(sortedSamples: number[], p: number): number;
export declare function runTokenOptimizationBenchmark(options: {
    stateDir?: string;
    iterations?: number;
}): Promise<ExtendedBenchmarkResult>;
export declare function runMemoryStoreBenchmark(options: {
    stateDir?: string;
    itemCount?: number;
    iterations?: number;
}): Promise<ExtendedBenchmarkResult>;
export declare function runMemoryRecallBenchmark(options: {
    stateDir?: string;
    seedCount?: number;
    iterations?: number;
}): Promise<ExtendedBenchmarkResult>;
export declare function runNgramIndexBenchmark(options: {
    stateDir?: string;
    docCount?: number;
    iterations?: number;
}): Promise<ExtendedBenchmarkResult>;
export declare function runKnowledgeFabricBenchmark(options: {
    stateDir?: string;
    iterations?: number;
}): Promise<ExtendedBenchmarkResult>;
export declare function runDashboardApiBenchmark(options: {
    baseUrl: string;
    iterations?: number;
}): Promise<ExtendedBenchmarkResult>;
interface RecallQualityResult extends ExtendedBenchmarkResult {
    r1: number;
    r5: number;
    r10: number;
    totalQueries: number;
    seedItems: number;
}
export declare function runRecallQualityBenchmark(options: {
    stateDir?: string;
    seedCount?: number;
}): Promise<RecallQualityResult>;
export declare function runBootstrapCostBenchmark(options: {
    stateDir?: string;
}): Promise<ExtendedBenchmarkResult>;
export interface BenchmarkReport {
    generatedAt: string;
    nexusVersion: string;
    results: ExtendedBenchmarkResult[];
    summary: {
        allTargetsMet: boolean;
        failures: string[];
    };
}
export declare function buildReport(results: ExtendedBenchmarkResult[], nexusVersion: string): BenchmarkReport;
export {};
