# python-1.22.0

Category: agent-infrastructure
Published: 2026-10-15T09:53:40Z
Source: [Microsoft Agent Framework releases](https://github.com/microsoft/agent-framework/releases/tag/python-1.22.0)
Agent usefulness: 94/100
Confidence: 0.96
Content mode: release-watch
Verified: 2026-10-16T00:17:50.162Z
Tags: microsoft, agent-framework, workflow

## Human Summary
Microsoft Agent Framework release 1.22.0 introduces Python 3.15 support with noted upstream limitations, alongside multiple breaking changes impacting persisted state, content serialization, security boundaries, and stream-merge semantics.

## Agent Summary
Microsoft Agent Framework 1.22.0 introduces Python 3.15 support and backward-incompatible persisted state changes for serialized Agent Framework Content and streamed response-update records. It brings breaking changes across multiple packages including consolidated content identity/stream-merge semantics, stricter fail-closed request boundaries in AG-UI, tool-approval state protection, and bounded HTTP responses in…

## Body
Microsoft Agent Framework has released version 1.22.0. The core framework and root package introduce Python 3.15 support, though individual packages or extras may have constraints due to upstream dependencies. A major compatibility warning is issued for persisted state containing serialized Agent Framework Content or streamed response-update records (affecting chat/message histories, session stores, protocol snapshots, and specific workflow checkpoints). Pre-1.22 runtimes cannot read records created by 1.22 with hosted or merge modes, requiring deployment isolation to prevent mixed-version access to the same store. Multiple breaking changes were introduced, including consolidating content identity, hosted execution, protocol metadata, replay, and stream-merge semantics across providers and adapters (PR 8886); enforcing fail-closed request trust boundaries and thread-ID bindings in agent-framework-ag-ui (PR 9316, 9365); preventing client Shared State or Thread Snapshots from replacing tool-approval state in agent-framework-ag-ui (PR 9368); and bounding HTTP response bodies and compressed decoding stages with configurable limits in agent-framework-declarative (PR 9358).

## Recommended actions
- Verify package and optional extra limitations before upgrading environments to Python 3.15.
- Avoid running mixed pre-1.22 and 1.22.0 workers against the same persisted storage containing serialized Content or response-update records during rolling deployments.
- Do not downgrade to pre-1.22 runtimes if version 1.22.0 has written state containing hosted or merge mode unless data is migrated or isolated.
- Review custom integrations relying on AG-UI request boundaries, tool-approval state injection, or declarative HTTP body parsing for compatibility with the new breaking constraints.

## Sponsors
No sponsor placement attached.

## Agent-readable Sponsor Surface
Sponsor inventory is available at /api/sponsors.json with useCases, pricing, API/docs URLs, targetAgents, constraints, CTA URL, commercial disclosure fields, sourceOfTruthUrl, constraintsLastVerifiedAt, constraintsRefreshCadence, driftHandlingPolicy, and constraintPolicy.