v2.36.0

pydantic/pydantic-aiv2.36.0Aug 29, 2026by dsfaccini

AI Summary

This release introduces `@durable_operation` for third-party execution engines, adds `--mcp-config` support and streaming to `clai`, and improves audio handling by accepting async iterables.

Key Highlights

  • Add `@durable_operation` for capabilities and a public backend API for durable execution engines
  • Add `--mcp-config` support and tool-call streaming to `clai`
  • Give instruction parts a stable `InstructionPart.id`
  • Accept async iterables in `RealtimeSession.send_audio()`

New Features

  • Public backend API for durable execution engines
  • Async iterables support in `RealtimeSession.send_audio()`
  • Stable `InstructionPart.id`

Full Release Notes

<!-- Release notes generated using configuration in .github/release.yml at main -->

## What's Changed
### ⚠️ Compatibility Notes
* Add `--mcp-config` support and tool-call streaming to `clai` by @Kludex in https://github.com/pydantic/pydantic-ai/pull/1374
### 🚀 Features
* Add `@durable_operation` for capabilities and a public backend API for third-party durable execution engines by @DouweM in https://github.com/pydantic/pydantic-ai/pull/6696
* Give instruction parts a stable `InstructionPart.id` by @DouweM in https://github.com/pydantic/pydantic-ai/pull/6887
* Accept async iterables in `RealtimeSession.send_audio()` and move the voice example to `listentome` by @DouweM in https://github.com/pydantic/pydantic-ai/pull/7860
* Require an explicit operation name on `@durable_operation` by @DouweM in https://github.com/pydantic/pydantic-ai/pull/7868
### 🐛 Bug Fixes
* Fix `TestModel` generation for narrow exclusive numeric bounds by @Terminator666666 in https://github.com/pydantic/pydantic-ai/pull/7800
* Project a bare `ToolDefinition` into Prefect cache keys by @DouweM in https://github.com/pydantic/pydantic-ai/pull/7872

## New Contributors
* @Terminator666666 made their first contribution in https://github.com/pydantic/pydantic-ai/pull/7800
* @mme made their first contribution in https://github.com/pydantic/pydantic-ai/pull/7432

**Full Changelog**: https://github.com/pydantic/pydantic-ai/compare/v2.35.3...v2.36.0