NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #1240 most downloaded on PyPI
Framework for evaluating stochastic code execution, especially code making use of LLMs
Latest stable
2.68.0
Last release 7 days ago
12 Nov 2026
Ships on a steady schedule
a new release about every 1 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
2 years old
310 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
list_prompts and get_prompt functionality to McpServer by @bdore in https://github.com/pydantic/pydantic-ai/pull/3889VercelAIAdapter's UIMessage.metadata by @Genmin in https://github.com/pydantic/pydantic-ai/pull/5279anthropic_eager_input_streaming in OpenRouterModel by @Alex-Resch in https://github.com/pydantic/pydantic-ai/pull/5656malformed_model_output and malformed_tool_use to FinishReason.error by @kuishou68 in https://github.com/pydantic/pydantic-ai/pull/5640type='adaptive' in _is_thinking_enabled by @sevakva in https://github.com/pydantic/pydantic-ai/pull/5651force_download flag from client-submitted FileUrl parts in UIAdapter.sanitize_messages by @colesmcintosh in https://github.com/pydantic/pydantic-ai/pull/5571None by @dfm88 in https://github.com/pydantic/pydantic-ai/pull/5188Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.102.0...v1.103.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
FileUrl into force_download='allow-local' on a URL that is, or could be, influenced by untrusted input, AND runs on a NAT64- or ISATAP-configured network (e.g. some IPv6-only or dual-stack-with-NAT64 Kubernetes setups).Agent.to_web / clai web; VercelAIAdapter; AGUIAdapter / Agent.to_ag_uistrict=None tools to strict mode with Bedrock, and skip strict field when botocore is too old by @shailendher in https://github.com/pydantic/pydantic-ai/pull/5580variable_instructions span attribute by @madanlalit in https://github.com/pydantic/pydantic-ai/pull/5487VercelAIAdapter now accepts providerExecuted / title on dynamic-tool message parts by @he-yufeng in https://github.com/pydantic/pydantic-ai/pull/5474WebFetchTool domain matching by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5592Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.101.0...v1.102.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
ctx.enqueue / agent_run.enqueue) by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4980XSearch capability model-agnostic via subagent fallback by @colesmcintosh in https://github.com/pydantic/pydantic-ai/pull/5120top_k model setting in GoogleModel, AnthropicModel, and CohereModel by @madanlalit in https://github.com/pydantic/pydantic-ai/pull/5558AnthropicModel dropping code execution tool results when continuing a conversation by @2830500285 in https://github.com/pydantic/pydantic-ai/pull/5568BaseModel tool arguments sent in wrapped form when the model uses default extra='ignore' by @macayu17 in https://github.com/pydantic/pydantic-ai/pull/5560xai-sdk 1.6.0 by @FU-max-boop in https://github.com/pydantic/pydantic-ai/pull/5355genai-prices minimum version by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/5565Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.100.0...v1.101.0
Deprecate gateway/gemini: prefix in favor of gateway/google-cloud: by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5543
<!-- Release notes generated using configuration in .github/release.yml at main -->
FileUrl into force_download='allow-local' on a URL that is, or could be, influenced by untrusted input.Agent.to_web / clai web; VercelAIAdapter; AGUIAdapter / Agent.to_ag_uigateway/gemini: prefix in favor of gateway/google-cloud: by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5543StreamedResponse.usage(); raise on region-less Gateway API keys by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5546evaluation_name / evaluator_version attribute pattern in favor of explicit accessor methods by @dmontagu in https://github.com/pydantic/pydantic-ai/pull/5554Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.99.0...v1.100.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
FileUrl into force_download='allow-local' on a URL that is, or could be, influenced by untrusted input.Agent.to_web / clai web; VercelAIAdapter; AGUIAdapter / Agent.to_ag_uigemini-3.5-flash model by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5527Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.98.0...v1.99.0
Deprecate pydantic_ai.ext.aci (tool_from_aci and ACIToolset) by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5510
<!-- Release notes generated using configuration in .github/release.yml at v1.98.0 -->
OpenAIResponsesModel.count_tokens) by @colesmcintosh in https://github.com/pydantic/pydantic-ai/pull/3951Agent tool_retries=/output_retries= with retries: int | AgentRetries by @Kludex in https://github.com/pydantic/pydantic-ai/pull/5500fastmcp.server at runtime by @Kymi808 in https://github.com/pydantic/pydantic-ai/pull/5514pydantic_ai.ext.aci (tool_from_aci and ACIToolset) by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5510Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.97.0...v1.98.0
…to google:, google-vertex: to google-cloud:; deprecate old names by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5336
<!-- Release notes generated using configuration in .github/release.yml at main -->
OnlineEvaluator.run_on_errors to opt into evaluating failed calls by @dmontagu in https://github.com/pydantic/pydantic-ai/pull/5456GoogleProvider(vertexai=True|False) into GoogleProvider + GoogleCloudProvider; rename provider ID google-gla: to google:, google-vertex: to google-cloud:; deprecate old names by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5336MCPToolset that uses fastmcp-slim[client], deprecate MCPServer* and FastMCPToolset by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5325ModelResponse.state to incomplete while response is still streaming by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/5455pydantic_graph.beta API out of beta, deprecate old API by @dmontagu in https://github.com/pydantic/pydantic-ai/pull/5306stream_responses() for stream_response(); new singular yields ModelResponse instead of (ModelResponse, is_last) tuple by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5296Agent.to_a2a() and bundled fasta2a integration; fasta2a has been adopted by DataLayer and users can use fasta2a.pydantic_ai (requires fasta2a v0.6.1) instead by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5426Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.96.1...v1.97.0
Deprecate Agent constructor prepare_tools=, prepare_output_tools=, event_stream_handler= in favor of PrepareTools, PrepareOutputTools, ProcessEventStr…
<!-- Release notes generated using configuration in .github/release.yml at main -->
Agent constructor prepare_tools=, prepare_output_tools=, event_stream_handler= in favor of PrepareTools, PrepareOutputTools, ProcessEventStream capabilities by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5335input_fidelity when None in image generation tool by @pydanty[bot] in https://github.com/pydantic/pydantic-ai/pull/5415openai_system_prompt_role in OpenAIResponsesModel by @navalprakhar in https://github.com/pydantic/pydantic-ai/pull/5430Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.96.0...v1.96.1
Deprecate Agent(history_processors=) in favor of capabilities=[ProcessHistory(...)] by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5425
<!-- Release notes generated using configuration in .github/release.yml at main -->
openai-chat: prefix and warn on bare openai: which will switch to use the Responses API in v2 by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5334Agent(history_processors=) in favor of capabilities=[ProcessHistory(...)] by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5425result.usage(), result.timestamp(), stream.get() in favor of property-style result.usage, result.timestamp, stream.response by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5263AGUIApp, Agent.to_ag_ui(), and pydantic_ai.ag_ui shim in favor of AGUIAdapter by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5345OutlinesModel and OutlinesProvider by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5432Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.95.1...v1.96.0
fix: un-deprecate Agent.instrument setter and InstrumentedModel by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5427
<!-- Release notes generated using configuration in .github/release.yml at main -->
current_otel_traceparent imports eager (unbreak agent runs in Temporal workflows) by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5422Agent.instrument setter and InstrumentedModel by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5427Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.95.0...v1.95.1
Add Instrumentation capability; deprecate Agent(instrument=...) by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4967
<!-- Release notes generated using configuration in .github/release.yml at main -->
Instrumentation capability; deprecate Agent(instrument=...) by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4967capabilities=[NativeTool(...)] by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5338local= opt-in for provider-adaptive capability fallback; deprecate auto-fallback by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5331tool-input-(available|error) on FunctionToolCallEvent by @sadra-barikbin in https://github.com/pydantic/pydantic-ai/pull/5292mistral as default dependency, exclude compromised 2.4.6 by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5393Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.94.0...v1.95.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
openai_chat_supports_multiple_system_messages profile flag by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5375mistralai as dependency from pydantic-ai by @Kludex in https://github.com/pydantic/pydantic-ai/pull/5384Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.93.0...v1.94.0
Yield OutputToolCallEvent/OutputToolResultEvent for output tool calls; deprecate function-tool events for failing output tool calls by @DouweM in http…
<!-- Release notes generated using configuration in .github/release.yml at main -->
tool_choice setting by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/3611OutputToolCallEvent/OutputToolResultEvent for output tool calls; deprecate function-tool events for failing output tool calls by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5320Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.92.0...v1.93.0
Add runtime output_retries override + deprecate retries + internal retry-field rename by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/50…
<!-- Release notes generated using configuration in .github/release.yml at main -->
output_retries override + deprecate retries + internal retry-field rename by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5075attempted exit cancel scope in different task by running MCP session in a dedicated task by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4514for_run RunContext with run_id, conversation_id, and metadata by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5330CaseLifecycle.teardown() by @voorhs in https://github.com/pydantic/pydantic-ai/pull/5322Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.91.0...v1.92.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
gpt-image-2 options by @banteg in https://github.com/pydantic/pydantic-ai/pull/5234deepseek-v4-flash anddeepseek-v4-pro by @SuperMarioYL in https://github.com/pydantic/pydantic-ai/pull/5195ModelResponse in OpenAI Chat assistant message mapping by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5300Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.90.0...v1.91.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
OpenAIResponsesModelSettings.openai_conversation_id by @corytomlinson in https://github.com/pydantic/pydantic-ai/pull/5224pydantic/ai-chat-ui 1.2.0 by @johnthagen in https://github.com/pydantic/pydantic-ai/pull/5246Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.89.1...v1.90.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
wrap_validation_errors on ToolManager function-tool methods by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5275anyio.Lock creation via cached_property to bind to running loop by @Kludex in https://github.com/pydantic/pydantic-ai/pull/5265Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.89.0...v1.89.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
conversation_id for cross-run correlation by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5251builtin_tools to agent.override by @mplemay in https://github.com/pydantic/pydantic-ai/pull/5248Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.88.0...v1.89.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
prepare_tools to function tools, add prepare_output_tools by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4859service_tier model setting; Anthropic + Gemini API + Vertex Priority PayGo support by @markmcd in https://github.com/pydantic/pydantic-ai/pull/4926fast mode for opus 4.6 by @bohdanhr in https://github.com/pydantic/pydantic-ai/pull/4300phase on assistant messages by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5229UIAdapter.sanitize_messages and allowed_file_url_schemes by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5228cache_control for anthropic_cache_messages by @Wh1isper in https://github.com/pydantic/pydantic-ai/pull/5227CallToolsNode stream fails by @thejens in https://github.com/pydantic/pydantic-ai/pull/4799Agent(retries=...) to user-provided toolsets by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4745Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.87.0...v1.88.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
HandleDeferredToolCalls capability and handle_deferred_tool_calls hook by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5142ProcessEventStream capability by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5141Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.86.1...v1.87.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
choices=None in streamed chunks (#5165) by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/5170container_id as string on reuse; unwrap broken {id: x} shape by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/5168input on tool-call retries by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5181MCPServer.__aexit__ called more times than __aenter__ in DynamicToolset by @anishesg in https://github.com/pydantic/pydantic-ai/pull/5171dict fields with Anthropic strict mode by @rahulmansharamani14 in https://github.com/pydantic/pydantic-ai/pull/4321gen_ai.operation.name=execute_tool on tool-execution spans by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5182Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.86.0...v1.86.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
UIAdapter.manage_system_prompt + ReinjectSystemPrompt capability by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4087messageId by @MukundaKatta in https://github.com/pydantic/pydantic-ai/pull/5156reasoning_content from Gemini 2.5 models by @JulieLiu99 in https://github.com/pydantic/pydantic-ai/pull/5155Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.85.1...v1.86.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
input from retry messages by @navalprakhar in https://github.com/pydantic/pydantic-ai/pull/4947dump_messages() by @tijmenhammer in https://github.com/pydantic/pydantic-ai/pull/4831Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.85.0...v1.85.1
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.84.1...v1.85.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
dict-shaped validated args to hooks for single-BaseModel tools by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5137Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.84.0...v1.84.1
…treating it as a hardening fix rather than a vulnerability.
<!-- Release notes generated using configuration in .github/release.yml at main -->
FileSearchTool response parsing by @DouweM in #5106. This was first released in yesterday's v1.83.0. The pattern was reachable in principle from Gemini streaming responses but could not be triggered via real Gemini output in testing, so we're treating it as a hardening fix rather than a vulnerability.OpenAICompaction by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5108OllamaModel subclass and correct Ollama capability flags to fix structured output on Ollama Cloud by @Goldokpa in https://github.com/pydantic/pydantic-ai/pull/4160openai_logprobs for streamed responses by @iAmir97 in https://github.com/pydantic/pydantic-ai/pull/5091openai_previous_response_id seeds by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5126new_messages() even with current run_id by @madanlalit in https://github.com/pydantic/pydantic-ai/pull/4731Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.83.0...v1.84.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
XSearchTool and FileSearch support for xAI by @colesmcintosh in https://github.com/pydantic/pydantic-ai/pull/4165FastMCPToolset by @Boryotto in https://github.com/pydantic/pydantic-ai/pull/4929Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.82.0...v1.83.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
openai_previous_response_id='auto' by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5086CombinedToolset and CombinedCapability by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5085ToolDefinition.function_signature by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5087Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.81.0...v1.82.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
run_id from cache key computation in PrefectAgentInputs by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/3890JsonSchemaTransformer by @Dharit13 in https://github.com/pydantic/pydantic-ai/pull/4989Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.80.0...v1.81.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
CapabilityOrdering (innermost, outermost, wraps, wrapped_by, requires`) by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5036Hooks ordering parameter and instance refs in wraps/wrapped_by by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5048OpenAICompaction and AnthropicCompaction capabilities by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4943get_wrapper_toolset iteration for consistency with wrap_ hooks by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5036mcp optional for DBOS module import by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5050Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.79.0...v1.80.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
dump_messages by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/3971create_async_http_client and context manager by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4421apply() to AbstractCapability, CombinedCapability, and WrapperCapability by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5022$refs in renamed schema defs, handle missing keywords, and detect semantically different defs by @Ricardo-M-L in https://github.com/pydantic/pydantic-ai/pull/5020run() when capability/hook overrides wrap_run_event_stream by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5028on_node_run_error and after_node_run hook recovery by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5023UserError messages by @graydeon in https://github.com/pydantic/pydantic-ai/pull/4976Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.78.0...v1.79.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
return_schema and function_signature to ToolDefinition by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/4964SetToolMetadata capability by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4964Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.77.0...v1.78.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
WebFetch tool and have WebFetch capability use it when provider lacks builtin support by @DEENUU1 in https://github.com/pydantic/pydantic-ai/pull/4906defer_loading to tools and toolsets to enable tool search by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4090ThreadExecutor capability and Agent.using_thread_executor() by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4942server_message_id in VercelAIEventStream by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4579ModelHTTPError/ModelAPIError by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4889Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.76.0...v1.77.0
Have ImageGeneration capability auto-fallback to subagent with imagegen model if main model lacks imagegen by @DouweM in https://github.com/pydantic/p
ImageGeneration capability auto-fallback to subagent with imagegen model if main model lacks imagegen by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4910agent to RunContext by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4922gen_ai.operation.name span attribute in agent runs by @adriangb in https://github.com/pydantic/pydantic-ai/pull/4936Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.75.0...v1.76.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
DataUIPart in Vercel AI adapter user message processing (#4704) by @sudo-nick in https://github.com/pydantic/pydantic-ai/pull/4712run_sync and run_stream for invalid output tool calls by @Spectual in https://github.com/pydantic/pydantic-ai/pull/4860Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.74.0...v1.75.0
deprecate: Dataset without name parameter by @Kludex in https://github.com/pydantic/pydantic-ai/pull/4862
<!-- Release notes generated using configuration in .github/release.yml at main -->
TextContent for user prompts with metadata not sent to model by @thisisarko in https://github.com/pydantic/pydantic-ai/pull/4432AbstractToolset.get_instructions method and include_instructions arg to MCP Servers by @DougTrajano in https://github.com/pydantic/pydantic-ai/pull/4123Dataset without name parameter by @Kludex in https://github.com/pydantic/pydantic-ai/pull/4862CallDeferred/ApprovalRequired from marking tool spans as errors by @jaiwinshah3 in https://github.com/pydantic/pydantic-ai/pull/4661service_tier validation failure for OpenAI-compatible providers by @majdalsado in https://github.com/pydantic/pydantic-ai/pull/4911gemini-embedding-2-preview by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4913ToolOutput.max_retries parameter by @JasonCZMeng in https://github.com/pydantic/pydantic-ai/pull/4687Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.73.0...v1.74.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
CaseLifecycle hooks to Dataset.evaluate by @dmontagu in https://github.com/pydantic/pydantic-ai/pull/4854ModelRetry for retry control flow by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4858ModelRequestContext by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4855x-ai matching genai-prices by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/4789>=1.24.0 by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/4863Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.72.0...v1.73.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
anthropic_eager_input_streaming to AnthropicModelSettings by @moe9195 in https://github.com/pydantic/pydantic-ai/pull/4842url= on MCP capability, in Python or AgentSpec by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4846Thinking capability type inference by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4846OpenRouterReasoning effort values by @majdalsado in https://github.com/pydantic/pydantic-ai/pull/4709ToolReturn metadata through Temporal serialization by @alvinttang in https://github.com/pydantic/pydantic-ai/pull/4684Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.71.0...v1.72.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
AgentSpec and Agent.from_file for loading agents from YAML/JSON, with support for templated instructions referencing deps (via TemplateStr) by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4640Hooks capability for defining hooks using decorators by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4640Thinking capability and cross-provider thinking model setting by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4640WebSearch, WebFetch, MCP, ImageGeneration that automatically fall back from builtin (provider) tools to local tools by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4640AbstractToolset.for_run and for_run_step for state isolation by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4640openai:gpt-5.4-mini and openai:gpt-5.4-nano by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/4787Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.70.0...v1.71.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
bedrock_inference_profile to BedrockModelSettings and BedrockEmbeddingSettings by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4697embedding_types to Cohere embed() to prevent SDK TypeError by @adityasingh2400 in https://github.com/pydantic/pydantic-ai/pull/4524Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.69.0...v1.70.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
description parameter to Agent and set gen_ai.agent.description on span by @Kludex in https://github.com/pydantic/pydantic-ai/pull/4677FallbackModel by @sarth6 in https://github.com/pydantic/pydantic-ai/pull/3786FunctionToolset.tool via tool/tool_plain split by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/4626details dict in Usage.__add__ to prevent mutation of or… by @sksvineeth in https://github.com/pydantic/pydantic-ai/pull/4606Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.68.0...v1.69.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
running tools parent span by @Kludex in #4560gpt-5.3-chat-latest by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4567Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.67.0...v1.68.0
<!-- Release notes generated using configuration in .github/release.yml at v1.68.0 -->
running tools parent span by @Kludex in https://github.com/pydantic/pydantic-ai/pull/4560gpt-5.3-chat-latest by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4567Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.67.0...v1.68.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
WebSearchTool for OpenRouterModel through OpenRouter plugins by @mochow13 in https://github.com/pydantic/pydantic-ai/pull/4022Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.66.0...v1.67.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
gemini-3.1-flash-image-preview) by @adtyavrdhn in https://github.com/pydantic/pydantic-ai/pull/4525TemporalAgent with multiple models by @mattbrandman in https://github.com/pydantic/pydantic-ai/pull/4100HasMatchingSpan YAML export/import round-trip for SpanQuery arguments by @debu-sinha in https://github.com/pydantic/pydantic-ai/pull/4454Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.65.0...v1.66.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
UploadedFile object by @mattbrandman in https://github.com/pydantic/pydantic-ai/pull/3942gemini-3.1-flash-lite-preview model by @rian-dolphin in https://github.com/pydantic/pydantic-ai/pull/4517__reduce__ to exception classes for pickle support by @OiPunk in https://github.com/pydantic/pydantic-ai/pull/4504Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.64.0...v1.65.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
template=False on PromptedOutput and NativeOutput to disable schema prompt by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4497run_id on ModelRequest in UI adapter runs by @madanlalit in https://github.com/pydantic/pydantic-ai/pull/4419ModelHTTPError/ModelAPIError by @saakshigupta2002 in https://github.com/pydantic/pydantic-ai/pull/4437__aexit__ guard inside lock to prevent TOCTOU race by @jameslcowan in https://github.com/pydantic/pydantic-ai/pull/4435BaseToolCallPart.has_content() incorrectly returns False for falsy arg values by @bsherifi in https://github.com/pydantic/pydantic-ai/pull/4442max_tokens by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4496dump_messages output with Vercel spec by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4196Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.63.0...v1.64.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
args_validator parameter to tools for pre-execution validation by @jerry-reevo in https://github.com/pydantic/pydantic-ai/pull/4016TracerProviders without add_span_processor by @AtharvaJaiswal005 in https://github.com/pydantic/pydantic-ai/pull/4328strip_markdown_fences to stop at closing fence by @sksvineeth in https://github.com/pydantic/pydantic-ai/pull/4398BuiltinToolCallPart.id for OpenAI Responses WebSearch/FileSearch by @yipstar in https://github.com/pydantic/pydantic-ai/pull/4391run_id instead of index by @madanlalit in https://github.com/pydantic/pydantic-ai/pull/4086Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.62.0...v1.63.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
tool_use_failed errors without tool name/args by retrying by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4354prompt_feedback and OpenAI refusals by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4315huggingface to 1.3.4 by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4119griffelib instead of griffe by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4313Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.61.0...v1.62.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.60.0...v1.61.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
video_url support to OpenRouterModel by @Adversarian in https://github.com/pydantic/pydantic-ai/pull/3824parent_message_id for back-to-back builtin tool calls by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4332_stream_text_deltas with aclosing to prevent StopAsyncIteration on client disconnect by @sheginabo in https://github.com/pydantic/pydantic-ai/pull/4205Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.59.0...v1.60.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Model.model_id property that returns provider:model by @tdevelope in https://github.com/pydantic/pydantic-ai/pull/3917Contains evaluator to support pydantic.BaseModel by @tomsquest in https://github.com/pydantic/pydantic-ai/pull/4003BaseChunks be injected through ToolReturnPart.metadata by @0xyjk in https://github.com/pydantic/pydantic-ai/pull/4230Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.58.0...v1.59.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
extra_headers support for Google model provider by @saakshigupta2002 in https://github.com/pydantic/pydantic-ai/pull/4241Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.57.0...v1.58.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.56.0...v1.57.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
anthropic_effort and anthropic_thinking.type='adaptive' by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4216anthropic_betas to AnthropicModelSettings by @bohdanhr in https://github.com/pydantic/pydantic-ai/pull/4180CachePoint placement with multiple trailing documents by @psg2 in https://github.com/pydantic/pydantic-ai/pull/4207FileUrls pointing at the local network by default by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4227Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.55.0...v1.56.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
OpenAIResponsesModel with "compatible" provider that returns reasoning_tokens as None instead by @alibeyram in https://github.com/pydantic/pydantic-ai/pull/4151MultiModalContent union missing discriminator causing incorrect deserialization by @jerry-reevo in https://github.com/pydantic/pydantic-ai/pull/4191Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.54.0...v1.55.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.53.0...v1.54.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.52.0...v1.53.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
openai_store setting to control data retention by @EliMeed in https://github.com/pydantic/pydantic-ai/pull/4142OpenAIChatModel send back reasoning content via field it's received in by @safina57 in https://github.com/pydantic/pydantic-ai/pull/4009BaseModel in format_as_xml by @bohdanhr in https://github.com/pydantic/pydantic-ai/pull/4131Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.51.0...v1.52.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
html_source parameter to customize Chat UI source by @madanlalit in https://github.com/pydantic/pydantic-ai/pull/3974Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.50.0...v1.51.0
<!-- Release notes generated using configuration in .github/release.yml at main -->
<!-- Release notes generated using configuration in .github/release.yml at main -->
usage_limits and model_settings to users running with to_cli() by @tommy-waltmann in https://github.com/pydantic/pydantic-ai/pull/4133TextPart.provider_details by @corytomlinson in https://github.com/pydantic/pydantic-ai/pull/3787BinaryContent returned by tool in Temporal by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4043DocumentUrl with custom media_type in Temporal by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/3968prompt_cache_retention literal from 'in-memory' to 'in_memory' by @davidfertube in https://github.com/pydantic/pydantic-ai/pull/4126Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.49.0...v1.50.0
One column per month.