more pleasant api functions for runtime