pydantic-ai

v1.95.0 Breaking

This release includes 2 breaking changes for platform teams planning a safe upgrade.

Published 21d AI Agents & Assistants

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agent-framework genai llm pydantic python

Affected surfaces

deps breaking_upgrade

ReleasePort's take

Moderate signal

editorial:auto 13d

Release v1.95.0 adds native Tool Search for Anthropic and OpenAI with custom strategies, while deprecating several Agent API patterns and renaming built‑in tools to native tools.

Why it matters: Plan migrations: rename 'built-in tools' to 'native tools', update registration via capabilities=[NativeTool(...)], and replace deprecated Agent(instrument=...) with Instrumentation capability before the next upgrade cycle.

Summary

AI summary

Native Tool Search added for Anthropic and OpenAI with custom strategies.

Changes in this release

Type	Severity	Summary	CVE
Breaking	Medium	rename ‘built-in tools’ to ‘native tools’, deprecate old fields, register via capabilities=[NativeTool(...)] rename ‘built-in tools’ to ‘native tools’, deprecate old fields, register via capabilities=[NativeTool(...)] Source: llm_adapter@2026-05-21 Confidence: high	—
Feature	Medium	native Tool Search on Anthropic and OpenAI with custom search strategies on any provider native Tool Search on Anthropic and OpenAI with custom search strategies on any provider Source: llm_adapter@2026-05-21 Confidence: high	—
Feature	Medium	support structured output + tool combination for Gemini 3 support structured output + tool combination for Gemini 3 Source: llm_adapter@2026-05-21 Confidence: high	—
Dependency	Medium	reinstate mistral as default dependency, exclude compromised 2.4.6 version reinstate mistral as default dependency, exclude compromised 2.4.6 version Source: llm_adapter@2026-05-21 Confidence: low	—
Deprecation	Medium	deprecate Agent(instrument=...) in favor of Instrumentation capability deprecate Agent(instrument=...) in favor of Instrumentation capability Source: llm_adapter@2026-05-21 Confidence: high	—
Deprecation	Medium	deprecate auto-fallback, add local= opt-in for provider-adaptive capability fallback deprecate auto-fallback, add local= opt-in for provider-adaptive capability fallback Source: llm_adapter@2026-05-21 Confidence: high	—
Bugfix
Bugfix	Medium	restore ability to swap the Bedrock client at runtime restore ability to swap the Bedrock client at runtime Source: llm_adapter@2026-05-21 Confidence: high	—
Bugfix	Medium	normalize Bedrock model IDs for capability profile lookup (Anthropic) normalize Bedrock model IDs for capability profile lookup (Anthropic) Source: llm_adapter@2026-05-21 Confidence: high	—
Bugfix	Medium	emit tool-input-(available\|error) on FunctionToolCallEvent (Vercel AI) emit tool-input-(available\|error) on FunctionToolCallEvent (Vercel AI) Source: llm_adapter@2026-05-21 Confidence: high	—

Full changelog

What's Changed

🚀 Features

feat: native Tool Search on Anthropic and OpenAI, with custom search strategies on any provider by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5143
Add Instrumentation capability; deprecate Agent(instrument=...) by @DouweM in https://github.com/pydantic/pydantic-ai/pull/4967
feat(google): support structured output + tool combination for Gemini 3 by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/4848

🆕 V2 Preparation (coming in June)

Rename “built-in tools” to “native tools”; deprecate old fields; register via capabilities=[NativeTool(...)] by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5338
Add local= opt-in for provider-adaptive capability fallback; deprecate auto-fallback by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5331

🐛 Bug Fixes

Restore ability to swap the Bedrock client at runtime by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5392
fix(anthropic): normalize Bedrock model IDs for capability profile lookup by @DouweM in https://github.com/pydantic/pydantic-ai/pull/5395
fix(vercel_ai): emit tool-input-(available|error) on FunctionToolCallEvent by @sadra-barikbin in https://github.com/pydantic/pydantic-ai/pull/5292

📦 Dependencies

Reinstate mistral as default dependency, exclude compromised 2.4.6 by @dsfaccini in https://github.com/pydantic/pydantic-ai/pull/5393

New Contributors

@sadra-barikbin made their first contribution in https://github.com/pydantic/pydantic-ai/pull/5292

Full Changelog: https://github.com/pydantic/pydantic-ai/compare/v1.94.0...v1.95.0

Breaking Changes

Deprecate `Agent(instrument=...)` in favor of the new `Instrumentation` capability
Rename “built-in tools” to “native tools”; deprecate old fields; require registration via `capabilities=[NativeTool(...)]`

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track pydantic-ai

Get notified when new releases ship.

About pydantic-ai

AI Agent Framework, the Pydantic way

All releases →