Refactor types for better readability

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

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

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

The issue points to utilities and error handling but names no file or test. Start by locating the utils code and its existing error paths, then determine which messages need more detail; done means the intended errors are descriptive and the relevant behavior is covered by the project's existing checks.

Written by the indexing model from the issue text.