Pydantic Ai Common Pitfalls

Catches the decorator and type annotation mistakes that trip up PydanticAI users most often. Shows you which tools need RunContext and which don't, how to fix "First parameter must be annotated with RunContext" errors, and why your deps aren't wiring up correctly. The debugging section is genuinely helpful: it walks you through message capture, explains when raw function registration is actually valid (despite looking wrong), and includes a gate checklist for those frustrating cases where the agent just silently does the wrong thing. Worth keeping open when you're setting up new agents or reviewing tool definitions, especially if you're switching between sync and async patterns.