Refactor api 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.

Start by locating the utils referenced in the issue and read the existing error-handling paths and their callers. Identify which errors currently lack useful context, then verify that the revised messages are more descriptive without changing the underlying behavior.

Written by the indexing model from the issue text.