We probably need to rethink the API. Let's address this as part of HSEARCH-1800 Open and resume publishing it when APIs are stable.