Source: github.com/pydantic/pydantic-ai/releases/tag/v2.69.0
The v2.69.0 release is listed on GitHub under the date 2026-11-16. Its compatibility notes start with RequestInput being folded into HandleDeferredToolCalls, whose handler can now take a resume token. The DockerSandbox harness capability becomes DockerContainer, with DockerSandbox kept as a deprecated alias, and BubblewrapSandbox is renamed BubblewrappedWorkspace.
The release adds support for Gemini 4 Hydrogen (gemini-4-hydrogen) on GoogleModel and service_tier support on GroqModel. Anthropic's tier spend cap and user-set spend limits now raise ModelQuotaExceededError. Several embedding, image generation and token counting failures now raise as ModelAPIError or ModelHTTPError instead of their previous types.
Sandbox support grows with KubernetesSandbox for kubernetes-sigs/agent-sandbox pods, plus network and secrets options for E2BSandbox, DaytonaSandbox and BoxdSandbox. A new ToolBudgets capability answers over-budget and repeated tool calls instead of raising, and DetectLoops now checks streamed thinking, text and tool call arguments for loops.
Why it matters if you build agents
Code that imports RequestInput or uses the BubblewrapSandbox name needs updating, and the DockerSandbox name keeps working only as an alias. Agents that branch on error types should recheck handling for Google embeddings, image generation and OpenAI image calls, since those now surface different exception classes. Teams that want loop detection or tool call budgets can use the new DetectLoops and ToolBudgets options without writing their own checks.
Get stories like this every weekday
One short email with the day's agent tooling news.