@spec build_error_response(term()) :: map() | [map()]

Builds a detailed error response from various error types.

Converts internal error tuples into structured error responses with clear messages and debugging context.

For Ash framework errors, uses the new Error protocol for standardized extraction.

Returns either a single error map or a list of error maps (for Ash errors with multiple sub-errors).