Support search configuration

**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.

Start by locating the hook handling and search configuration entry points in the Shell-based terminal agent. Trace how hook failures are currently reported and check any existing tests; done means search configuration is supported and hook errors provide the requested detailed context.

Written by the indexing model from the issue text.