# Microsoft releases agent-framework python-1.22.0 with breaking changes

published: 2026-10-15T10:06:12.405Z
topic: frameworks
source: https://github.com/microsoft/agent-framework/releases/tag/python-1.22.0
url: https://aiagentnews.io/stories/microsoft-releases-agent-framework-python-1-22-0-with-breaking-changes

Microsoft released python-1.22.0 of its agent-framework Python packages on October 15, 2026. The release adds Python 3.15 support to the core package, flags several breaking changes, and warns about persisted-state compatibility.

The changelog for python-1.22.0 is dated October 15, 2026. The core framework and root agent-framework package now support Python 3.15, but not every package, optional extra, or feature does yet because of upstream dependency constraints.

The release adds a dedicated Cosmos memory provider, configurable service URLs for the Ollama and OpenAI chat clients, and forwarding of Oracle connection-pool settings. It also surfaces OAuth consent requests in non-streaming Foundry responses. Several changes are labeled breaking, including consolidated content identity and stream-merge semantics, stricter request trust checks in AG-UI, and a configurable limit on HTTP response bodies in the declarative package.

The changelog warns that pre-1.22 runtimes cannot read new records containing hosted or merge_mode. It advises against running old and new workers on the same affected store during a rolling deployment.

## Why it matters if you build agents

Teams using AG-UI, the declarative package, or stored chat histories and checkpoints should review the breaking changes before upgrading.

Avoid running old and new workers against the same affected store during a rollout, and do not downgrade after 1.22 has written new records unless that state is isolated or migrated.

Check each package's README for Python 3.15 support before upgrading, since support varies by package and extra.