enhanced search capabilities, improved error handling and docs