Sourced frompydantic-ai's releases.

v0.4.10 (2025-07-30)

What's Changed

• Fix parallel tool calling with tools returning ToolReturn with content by@​DouweM inpydantic/pydantic-ai#2365
• Always enter Toolset context when running agent by@​strawgate inpydantic/pydantic-ai#2361
• Addpriorityservice_tier toOpenAIModelSettings and respect it inOpenAIResponsesModel by@​akenarsari inpydantic/pydantic-ai#2368
• Add HTTP Referer request header to Vercel AI Gateway provider by@​joshualipman123 inpydantic/pydantic-ai#2369

New Contributors

• @​akenarsari made their first contribution inpydantic/pydantic-ai#2368

Full Changelog:pydantic/pydantic-ai@v0.4.9...v0.4.10

v0.4.9 (2025-07-28)

What's Changed

• Ensure AG-UI state is isolated between requests by@​DouweM inpydantic/pydantic-ai#2343
• Refine retry logic for parallel tool calling by@​DouweM inpydantic/pydantic-ai#2317
• Fix AgentStream.stream_output and StreamedRunResult.stream_structured with output tools by@​DouweM inpydantic/pydantic-ai#2314
• Allowdefault in tool schema with Gemini by@​strawgate inpydantic/pydantic-ai#2309

Full Changelog:pydantic/pydantic-ai@v0.4.8...v0.4.9

v0.4.8 (2025-07-28)

What's Changed

• Add tenacity utilities/integration for improved retry handling by@​dmontagu inpydantic/pydantic-ai#2282
• fix: close initialized MCP server if any MCP server fails to initalize by@​hartungstenio inpydantic/pydantic-ai#2312
• Adding thinkingpart to otel_events in ModelResponse by@​adtyavrdhn inpydantic/pydantic-ai#2237
• Fix: TypeError in MCPServerSSE due to improper initialization by@​tradeqvest inpydantic/pydantic-ai#2319
• Fix: AG-UI assistant text and tool call order by@​ChuckJonas inpydantic/pydantic-ai#2328

New Contributors

• @​hartungstenio made their first contribution inpydantic/pydantic-ai#2312
• @​tradeqvest made their first contribution inpydantic/pydantic-ai#2319
• @​ChuckJonas made their first contribution inpydantic/pydantic-ai#2328

Full Changelog:pydantic/pydantic-ai@v0.4.7...v0.4.8

v0.4.7 (2025-07-24)

What's Changed

• Add MoonshotAI provider with Kimi-K2 model support by@​zachmayer inpydantic/pydantic-ai#2211
• Add Vercel AI Gateway provider by@​joshualipman123 inpydantic/pydantic-ai#2277
• Support passing files uploaded to Gemini Files API and setting custom media type by@​dprov inpydantic/pydantic-ai#2270
• Parse '' tags in streamed text as thinking parts by@​DouweM inpydantic/pydantic-ai#2290
• RenameMCPServersse_read_timeout toread_timeout and pass toClientSession by@​AntSan813 inpydantic/pydantic-ai#2240
• Update cohere and MCP, add support for MCP ResourceLink returned from tools by@​medaminezghal inpydantic/pydantic-ai#2094
• Ignore empty text alongside tool calls when streaming from Ollama by@​DouweM inpydantic/pydantic-ai#2286
• Ignore leading whitespace when streaming text, fixing run_stream + Ollama + Qwen3 by@​DouweM inpydantic/pydantic-ai#2294
• Fix AG-UI parallel tool calls by@​DouweM inpydantic/pydantic-ai#2301
• Fix initial tool call args not being streamed with AG-UI by@​DouweM inpydantic/pydantic-ai#2303
• HandleNonecreated timestamp coming from OpenRouter API by@​R0boji inpydantic/pydantic-ai#2247

... (truncated)

Sourced frompydantic-ai's changelog.

Upgrade Guide

Pydantic AI is still pre-version 1, so breaking changes will occur, however:

• We try to minimize them as much as possible.
• We use minor version bumps to signify breaking changes.
• Wherever possible we deprecate old features so code continues to work with deprecation warnings when changing the public API.
• We intend to release V1 in summer 2025, and then follow strict semantic versioning, e.g. no intentional breaking changes except in minor or patch versions.

Breaking Changes

!!! noteHere's a filtered list of the breaking changes for each version to help you upgrade Pydantic AI.

v0.4.0 (2025-07-08)

See#1799 - Pydantic EvalsEvaluationReport andReportCase are now generic dataclasses instead of Pydantic models. If you were serializing them usingmodel_dump(), you will now need to use theEvaluationReportAdapter andReportCaseAdapter type adapters instead.

See#1507 - TheToolDefinitiondescription argument is now optional and the order of positional arguments has changed fromname, description, parameters_json_schema, ... toname, parameters_json_schema, description, ... to account for this.

v0.3.0 (2025-06-18)

See#1142 — Adds support for thinking parts.

We now convert the thinking blocks ("<think>..."</think>") in provider specific text parts toPydantic AIThinkingParts. Also, as part of this release, we made the choice to not send back theThinkingParts to the provider - the idea is to save costs on behalf of the user. In the future, weintend to add a setting to customize this behavior.

v0.2.0 (2025-05-12)

See#1647 — usage makes sense as part ofModelResponse, and could be really useful in "messages" (really a sequence of requests and response). In this PR:

• Addsusage toModelResponse (field has a default factory ofUsage() so it'll work to load data that doesn't have usage)
• changes the return type ofModel.request to justModelResponse instead oftuple[ModelResponse, Usage]

v0.1.0 (2025-04-15)

See#1248 — the attribute/parameter nameresult was renamed tooutput in many places. Hopefully all changes keep a deprecated attribute or parameter with the old name, so you should get many deprecation warnings.

See#1484 —format_as_xml was moved and made available to import from the package root, e.g.from pydantic_ai import format_as_xml.

---

Full Changelog

... (truncated)

• 80a7284 Addpriorityservice_tier toOpenAIModelSettings and respect it in `Ope...
• 29c72a6 Always enter Toolset context when running agent (#2361)
• 0584724 Add HTTP Referer request header to Vercel AI Gateway provider (#2369)
• 3e1f634 Fix parallel tool calling with tools returning ToolReturn with content (#2365)
• c7a3591 Revert "Remove older deprecated models of Anthropic" (#2358)
• 8f20f9b Remove older deprecated models of Anthropic (#2345)
• 362dcbf Set up environment for@​claude, allow it make and uv, and reading CI logs (#2...
• ab92e67 Refine retry logic for parallel tool calling (#2317)
• 2fca506 Ensure AG-UI state is isolated between requests. (#2343)
• 168680a Fix AgentStream.stream_output and StreamedRunResult.stream_structured with ou...
• Additional commits viewable incompare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)