/**
 * System Resource Detection
 *
 * Provides vCPU, VRAM, and memory detection with caching.
 * Used to auto-tune parallelism across the UAP system.
 *
 * Env override: UAP_MAX_PARALLEL always takes precedence.
 * Precedence: env var → config → auto-detect → hardcoded default
 */
export interface SystemResources {
    /** Number of logical CPUs (vCPUs / hardware threads) */
    vCPUs: number;
    /** GPU VRAM in GB (0 if no GPU detected) */
    vramGB: number;
    /** System RAM in GB */
    memoryGB: number;
}
/**
 * Detect system resources (cached after first call).
 */
export declare function detectSystemResources(): SystemResources;
/**
 * Compute safe parallelism ceiling.
 *
 * @param mode - 'cpu' for compute-bound work (reserves cores for OS + inference),
 *               'io' for IO-bound work like API calls (higher concurrency safe)
 * @returns Maximum number of concurrent operations
 *
 * Precedence:
 *   1. UAP_MAX_PARALLEL env var (always wins)
 *   2. Auto-detected from os.cpus()
 *   3. Hardcoded fallback (3)
 */
export declare function getMaxParallel(mode?: 'cpu' | 'io'): number;
/**
 * Check if parallelism is globally enabled.
 *
 * Precedence:
 *   1. UAP_PARALLEL env var ('false' disables)
 *   2. Default: true
 */
export declare function isParallelEnabled(): boolean;
/**
 * Reset cached resources (for testing).
 */
export declare function resetResourceCache(): void;
//# sourceMappingURL=system-resources.d.ts.map