Python: bump package versions for 1.2.2 release

[moonbox3]

Summary

Cuts the python-1.2.2 release. PATCH bump on the released cohort (agent-framework, agent-framework-core, agent-framework-openai, agent-framework-foundry: 1.2.1 → 1.2.2), driven by the OpenAI file_search citations fix (#5557). All 21 beta packages stamp 1.0.0b260429 and all 4 alpha packages — now including the new agent-framework-azure-contentunderstanding — stamp 1.0.0a260429 per the lockstep convention. Date stamp reflects 2026-04-29 Pacific.

Two follow-on bundled fixes to keep validate-dependency-bounds-test green at lowest-direct resolution:

• agent-framework-azure-contentunderstanding: bump azure-ai-contentunderstanding lower bound from >=1.0.0 to >=1.0.1 (1.0.0 ships without proper typing — pyright reports 65 unknown-type errors)
• core/agent_framework/foundry/__init__.pyi: pyright # pyright: ignore[reportMissingImports] / [reportUnknownVariableType] on the new alpha package's stub imports, since alpha packages aren't in core's [all] extra and therefore aren't installed at lowest-direct

See python/CHANGELOG.md for the full set of changes shipping in this release.

[moonbox3]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
packages/core/agent_framework/_workflows
_workflow.py	278	19	93%	91, 270–272, 274–275, 293, 297, 461, 674, 695, 743, 755, 761, 766, 786–788, 839
packages/declarative/agent_framework_declarative/_workflows
_declarative_base.py	462	58	87%	47, 50, 154, 242, 256, 270, 281, 298, 425–426, 433–434, 449, 479, 562–564, 566–568, 570, 573, 580, 606, 632–638, 640–641, 643–651, 672–673, 675–676, 964–967, 989–990, 997–998, 1003, 1012–1013, 1019
TOTAL	30583	3559	88%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
6152	30 💤	0 ❌	0 🔥	1m 35s ⏱️

[github-actions]

Automated Code Review

Reviewers: 4 | Confidence: 95%

✓ Correctness

This is a straightforward version bump release (1.2.1 → 1.2) with consistent dependency updates across all packages, CHANGELOG additions, import consolidation in sample files, minor formatting changes, and pyright ignore directives in the type stub. All formatting changes (removing line-continuation parentheses in _workflow.py and _declarative_base.py) preserve identical semantics — the parentheses were purely for line wrapping and did not affect expression grouping. No correctness issues found.

✓ Security Reliability

This is a routine release version bump from 1.2.1 to 1.2.2 across all Python packages. Changes include version bumps in pyproject.toml files and uv.lock, CHANGELOG additions, import consolidation in sample files, minor code formatting changes (removing line-continuation parentheses), and pyright ignore comments in type stubs. All formatting changes are semantically equivalent to the originals. No security or reliability concerns identified.

✓ Test Coverage

This is a release version-bump PR (1.2.1 → 1.2.2) that updates package versions across all Python workspace packages, updates the CHANGELOG, and applies minor formatting changes (line wrapping, import reordering, pyright ignore comments). All code changes in _workflow.py, _declarative_base.py, foundry/init.py, foundry/init.pyi, and test_workflow_factory.py are purely cosmetic reformatting with no behavioral changes. The sample import reorganizations consolidate duplicate import blocks. Since no new behavior is introduced, no new tests are needed. Existing test assertions in test_workflow_factory.py are reformatted but semantically unchanged.

✓ Design Approach

I found two release-packaging design issues worth addressing before shipping 1.2.2/1.0.0a260429. First, the newly published agent-framework-azure-contentunderstanding package is not self-contained relative to its own documented install path: its README tells users to install only that package, but the basic example immediately imports FoundryChatClient from agent_framework.foundry, which is not declared as a dependency. Second, agent-framework-foundry still allows agent-framework-openai>=1.1.0 even though Foundry is tightly coupled to OpenAI internals and this same release advertises an OpenAI-side Responses/history fix; that stale lower bound lets resolvers produce mismatched package sets.

---

Automated review by moonbox3's agents

[Copilot]

Pull request overview

Cuts the Python 1.2.2 release by updating workspace/package versions, refreshing dependency bounds needed for lowest-direct CI, and aligning changelog + type-checking ergonomics for newly introduced packages.

Changes:

• Bump released cohort (agent-framework* stable packages) from 1.2.1 → 1.2.2, and stamp beta/alpha packages to 1.0.0b260429 / 1.0.0a260429.
• Raise azure-ai-contentunderstanding lower bound to >=1.0.1 and align agent-framework-azure-contentunderstanding core dependency to >=1.2.2,<2.
• Update changelog links/entries and adjust a few formatting/import/type-checking details to keep lint/type-check/test workflows green.

Reviewed changes

Copilot reviewed 41 out of 42 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
python/uv.lock	Updates locked workspace package versions and CU dependency floor (azure-ai-contentunderstanding>=1.0.1).
python/pyproject.toml	Bumps root meta-package to 1.2.2 and pins agent-framework-core[all]==1.2.2.
python/CHANGELOG.md	Adds 1.2.2 release notes and updates compare links ([Unreleased], [1.2.2]).
python/packages/core/pyproject.toml	Bumps agent-framework-core to 1.2.2.
python/packages/openai/pyproject.toml	Bumps agent-framework-openai to 1.2.2 and updates core dependency floor.
python/packages/foundry/pyproject.toml	Bumps agent-framework-foundry to 1.2.2 and updates core dependency floor.
python/packages/core/agent_framework/_workflows/_workflow.py	Minor formatting refactor (no functional change intended).
python/packages/declarative/pyproject.toml	Bumps declarative package beta stamp and core dependency floor.
python/packages/declarative/tests/test_workflow_factory.py	Minor assertion formatting cleanup in regression coverage.
python/packages/declarative/agent_framework_declarative/_workflows/_declarative_base.py	Minor formatting changes in message/history handling (one line needs clarity).
python/packages/core/agent_framework/foundry/init.py	Wraps long _IMPORTS entry for readability.
python/packages/core/agent_framework/foundry/init.pyi	Adds pyright ignores for optional alpha-package stub imports.
python/packages/azure-contentunderstanding/pyproject.toml	Bumps alpha stamp; raises CU SDK lower bound; aligns core dependency to >=1.2.2,<2.
python/packages/azure-contentunderstanding/samples/02-devui/01-multimodal_agent/agent.py	Import reordering/cleanup for sample.
python/packages/azure-contentunderstanding/samples/02-devui/02-file_search_agent/foundry_backend/agent.py	Import grouping cleanup for sample.
python/packages/azure-contentunderstanding/samples/01-get-started/01_document_qa.py	Consolidates foundry imports for sample.
python/packages/azure-contentunderstanding/samples/01-get-started/02_multi_turn_session.py	Consolidates foundry imports for sample.
python/packages/azure-contentunderstanding/samples/01-get-started/03_multimodal_chat.py	Consolidates foundry imports for sample.
python/packages/azure-contentunderstanding/samples/01-get-started/04_invoice_processing.py	Consolidates foundry imports for sample.
python/packages/a2a/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/ag-ui/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/anthropic/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/azure-ai-search/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/azure-cosmos/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/azurefunctions/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/bedrock/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/chatkit/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/claude/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/copilotstudio/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/devui/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/durabletask/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/foundry_hosting/pyproject.toml	Bumps alpha stamp; updates core dependency floor.
python/packages/foundry_local/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/gemini/pyproject.toml	Bumps alpha stamp; updates core dependency floor.
python/packages/github_copilot/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/hyperlight/pyproject.toml	Bumps alpha stamp; updates core dependency floor.
python/packages/lab/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/mem0/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/ollama/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/orchestrations/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/purview/pyproject.toml	Bumps beta stamp; updates core dependency floor.
python/packages/redis/pyproject.toml	Bumps beta stamp; updates core dependency floor.