Refactor utils for better readability

**Problem**
When working with helpers, 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 identified in the issue. Start by locating the helper utilities and their existing error-handling paths, then review how current messages are produced. Done means the scope is agreed, error messages are more descriptive, and relevant checks pass.

Written by the indexing model from the issue text.