Add configuration options for search

**Problem**
When working with hooks, the error messages could be more descriptive.

**Suggestion**
Improve error handling and add detailed error messages.

**Context**
This would help with debugging and maintenance.

No files, tests, or entry points are named. First locate the search configuration and hook error-handling areas, then clarify the intended options and error-message cases with the maintainers; done requires agreed behavior and tests covering it.

Written by the indexing model from the issue text.