Python: Bump package versions for 1.12.0 release - #7238
Conversation
Bump packages represented in the 1.12.0 changelog, promote Foundry Hosting, Azure Content Understanding, Gemini, Mistral, Monty, and Tools to beta, and apply the requested beta cohort date stamp. Root and core move to 1.12.0, released and RC packages use their selected increments, alpha packages including Hosting MCP use the 260721 stamp, and core floors are raised only for proven consumers. Copilot-Session: 2dd9980a-b869-4c16-8642-75b7a6d6ebdf
Python Test Coverage Report •
Python Unit Test Overview
|
||||||||||||||||||||||||||||||||||||||||
There was a problem hiding this comment.
Automated Code Review
Reviewers: 5 | Confidence: 91%
✓ Correctness
No actionable issues found in this dimension.
✓ Security Reliability
No actionable issues found in this dimension.
✓ Test Coverage
The PR adds good test coverage for the new lazy-loading namespaces (gemini, mistral, monty, tools) following a consistent 4-test pattern. However, the foundry namespace test was updated to cover
ResponsesHostServerbut omits assertions for the other two newly-addedagent_framework_foundry_hostingsymbols (FoundryToolboxandInvocationsHostServer) that were added in the same change.
✓ Failure Modes
No actionable issues found in this dimension.
✗ Design Approach
I found two user-facing design regressions in the release-surface changes. The new get-started install guidance no longer installs everything the samples import, and the relocated Azure Content Understanding scripts dropped
azure-identityfrom their PEP 723 dependency headers even though they now importAzureCliCredential, which breaks the advertiseduv runpath in a clean environment. That makes the README steer users into a broken setup path for part of the sample set.
Flagged Issues
-
python/samples/01-get-started/README.md:9now tells users to install onlyagent-framework-foundry, but the first samples immediately importazure.identity(01_hello_agent.py:5-7,02_add_tools.py:7-10).agent-framework-foundryitself does not depend onazure-identity(python/packages/foundry/pyproject.toml:25-30), so the documented onboarding flow is incomplete. - The relocated Azure Content Understanding scripts dropped
azure-identityfrom their PEP 723 dependency headers (01_document_qa.py:4-7,02_multi_turn_session.py:4-7,03_multimodal_chat.py:4-7,04_invoice_processing.py:4-8,05_large_doc_file_search.py:4-7) even though each script importsAzureCliCredential. Becauseagent-framework-foundrydoes not supplyazure-identity,uv runon these samples no longer installs a required import. - python/samples/03-workflows/README.md:5 says workflow support ships with
agent-framework-core, but orchestration samples in this directory importagent_framework.orchestrationswhich is only a lazy wrapper that raisesModuleNotFoundErrorunlessagent-framework-orchestrationsis installed (python/packages/core/agent_framework/orchestrations/__init__.py:19-20,72-79).
Automated review by eavanvalkenburg's agents
|
Flagged issue
Source: automated DevFlow PR review |
|
Flagged issue The relocated Azure Content Understanding scripts dropped Source: automated DevFlow PR review |
|
Flagged issue python/samples/03-workflows/README.md:5 says workflow support ships with Source: automated DevFlow PR review |
There was a problem hiding this comment.
Pull request overview
Prepares the Python 1.12.0 release by bumping package versions and aligning dependency/extra surfaces with this cycle’s lifecycle promotions (notably new/promoted beta integrations) while updating samples/docs to use the new root agent_framework.* lazy-loaded namespaces and relocated sample structure.
Changes:
- Bump
agent-framework/agent-framework-coreto1.12.0, update promoted package versions, and refreshuv.lock. - Promote/select packages to beta and expose them via new lazy-loaded namespaces (
agent_framework.tools,.monty,.mistral,.gemini), with core tests covering these namespaces. - Relocate/package-align samples and documentation (install guidance, import paths, DevUI agents, and hosting samples) to reflect the promoted distributions and new namespaces.
Reviewed changes
Copilot reviewed 155 out of 160 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| python/uv.lock | Update locked versions/extras for the 1.12.0 release and promoted packages. |
| python/pyproject.toml | Bump root meta-package version to 1.12.0 and pin core to 1.12.0. |
| python/CHANGELOG.md | Add 1.12.0 release notes and update compare links. |
| python/PACKAGE_STATUS.md | Update lifecycle status matrix (promotions to beta, additions). |
| python/samples/README.md | Update sample install guidance and prerequisites text. |
| python/samples/AGENTS.md | Update sample install guidance to prefer specific distributions and prerelease flags. |
| python/samples/01-get-started/README.md | Update install guidance and note additional prerelease requirement for Azure Functions sample. |
| python/samples/03-workflows/README.md | Update workflow install guidance to use agent-framework-core + graphviz. |
| python/samples/03-workflows/orchestrations/README.md | Update orchestrations sample install guidance to direct package install. |
| python/samples/03-workflows/parallelism/map_reduce_and_visualization.py | Update install/tip text for visualization dependencies. |
| python/samples/04-hosting/foundry-hosted-agents/README.md | Update Monty lifecycle wording (alpha→beta) and package naming. |
| python/samples/04-hosting/foundry-hosted-agents/invocations/01_basic/main.py | Switch hosting imports to agent_framework.foundry consolidated namespace. |
| python/samples/04-hosting/foundry-hosted-agents/responses/01_basic/main.py | Switch hosting imports to agent_framework.foundry consolidated namespace. |
| python/samples/04-hosting/foundry-hosted-agents/responses/02_tools/main.py | Switch hosting imports to agent_framework.foundry consolidated namespace. |
| python/samples/04-hosting/foundry-hosted-agents/responses/03_mcp/main.py | Switch hosting imports to agent_framework.foundry consolidated namespace. |
| python/samples/04-hosting/foundry-hosted-agents/responses/04_foundry_toolbox/main.py | Switch hosting imports to agent_framework.foundry consolidated namespace. |
| python/samples/04-hosting/foundry-hosted-agents/responses/05_workflows/main.py | Switch hosting imports to agent_framework.foundry consolidated namespace. |
| python/samples/04-hosting/foundry-hosted-agents/responses/06_files/main.py | Switch hosting imports to agent_framework.foundry consolidated namespace. |
| python/samples/04-hosting/foundry-hosted-agents/responses/07_observability/main.py | Switch hosting imports to agent_framework.foundry consolidated namespace. |
| python/samples/04-hosting/foundry-hosted-agents/responses/08_azure_search_rag/main.py | Switch hosting imports to agent_framework.foundry consolidated namespace. |
| python/samples/04-hosting/foundry-hosted-agents/responses/09_foundry_skills/main.py | Switch hosting imports to agent_framework.foundry consolidated namespace. |
| python/samples/04-hosting/foundry-hosted-agents/responses/10_foundry_memory/main.py | Switch hosting imports to agent_framework.foundry consolidated namespace. |
| python/samples/04-hosting/foundry-hosted-agents/responses/11_monty_codeact/README.md | Update Monty lifecycle wording (alpha→beta). |
| python/samples/04-hosting/foundry-hosted-agents/responses/11_monty_codeact/pyproject.toml | Update comments and prerelease guidance for Monty beta. |
| python/samples/04-hosting/foundry-hosted-agents/responses/11_monty_codeact/main.py | Switch Monty/hosting imports to agent_framework.monty + agent_framework.foundry. |
| python/samples/04-hosting/foundry-hosted-agents/responses/12_foundry_toolbox_mcp_skills/main.py | Switch hosting/toolbox imports to agent_framework.foundry. |
| python/samples/04-hosting/foundry-hosted-agents/responses/13_declarative_customer_support/main.py | Switch hosting imports to agent_framework.foundry. |
| python/samples/04-hosting/container/hyperlight_codeact/main.py | Switch hosting imports to agent_framework.foundry. |
| python/samples/04-hosting/a2a/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/durabletask/01_single_agent/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/durabletask/02_multi_agent/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/durabletask/03_single_agent_streaming/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/durabletask/04_single_agent_orchestration_chaining/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/durabletask/05_multi_agent_orchestration_concurrency/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/durabletask/07_single_agent_orchestration_hitl/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/azure_functions/01_single_agent/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/azure_functions/02_multi_agent/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/azure_functions/03_reliable_streaming/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/azure_functions/04_single_agent_orchestration_chaining/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/azure_functions/05_multi_agent_orchestration_concurrency/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/azure_functions/06_multi_agent_orchestration_conditionals/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/azure_functions/07_single_agent_orchestration_hitl/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/azure_functions/08_mcp_server/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/azure_functions/09_workflow_shared_state/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/azure_functions/10_workflow_no_shared_state/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/azure_functions/12_workflow_hitl/requirements.txt | Remove redundant direct azure-identity requirement from sample requirements. |
| python/samples/04-hosting/af-hosting/local_telegram/pyproject.toml | Remove explicit azure-identity from sample dependencies. |
| python/samples/04-hosting/af-hosting/local_telegram/app.py | Update PEP 723 header dependency list (remove unused entries). |
| python/samples/04-hosting/af-hosting/local_telegram/polling_app.py | Update PEP 723 header dependency list (remove unused entries). |
| python/samples/04-hosting/af-hosting/local_responses/pyproject.toml | Remove explicit azure-identity from sample dependencies. |
| python/samples/04-hosting/af-hosting/local_responses_workflow/pyproject.toml | Remove explicit azure-identity from sample dependencies. |
| python/samples/05-end-to-end/evaluation/red_teaming/red_team_agent_sample.py | Add duckdb dependency and update install guidance to use agent-framework-foundry. |
| python/samples/05-end-to-end/evaluation/red_teaming/README.md | Update install guidance for red teaming sample. |
| python/samples/02-agents/providers/README.md | Add provider folders for Gemini and Mistral samples. |
| python/samples/02-agents/providers/openai/client_with_local_shell.py | Switch shell tool import to agent_framework.tools. |
| python/samples/02-agents/providers/mistral/README.md | Add new Mistral provider sample README. |
| python/samples/02-agents/providers/mistral/mistral_embeddings.py | Add PEP 723 header and switch import to agent_framework.mistral. |
| python/samples/02-agents/providers/gemini/README.md | Add new Gemini provider sample README. |
| python/samples/02-agents/providers/gemini/gemini_basic.py | Add PEP 723 header and switch import to agent_framework.gemini. |
| python/samples/02-agents/providers/gemini/gemini_advanced.py | Add PEP 723 header and switch imports to agent_framework.gemini. |
| python/samples/02-agents/providers/gemini/gemini_with_google_search.py | Add PEP 723 header and switch import to agent_framework.gemini. |
| python/samples/02-agents/providers/gemini/gemini_with_google_maps.py | Add PEP 723 header and switch import to agent_framework.gemini. |
| python/samples/02-agents/providers/gemini/gemini_with_code_execution.py | Add PEP 723 header and switch import to agent_framework.gemini. |
| python/samples/02-agents/tools/local_shell_with_environment_provider.py | Switch shell tool imports to agent_framework.tools. |
| python/samples/02-agents/tools/local_shell_with_allowlist.py | Switch shell tool imports to agent_framework.tools. |
| python/samples/02-agents/tools/local_code_interpreter/README.md | Update install guidance to prefer specific prerelease distributions. |
| python/samples/02-agents/tools/monty_code_interpreter/README.md | Update install guidance and Monty lifecycle wording (alpha→beta). |
| python/samples/02-agents/tools/monty_code_interpreter/monty_code_interpreter.py | Switch import to agent_framework.monty and update install guidance text. |
| python/samples/02-agents/tools/monty_code_interpreter/monty_code_interpreter_manual_wiring.py | Switch import to agent_framework.monty and update install guidance text. |
| python/samples/02-agents/harness/README.md | Update text and shell tool import path. |
| python/samples/02-agents/harness/harness_research.py | Remove redundant azure-identity from PEP 723 header list. |
| python/samples/02-agents/harness/harness_data_processing.py | Remove redundant azure-identity from PEP 723 header list. |
| python/samples/02-agents/harness/build_your_own_claw/claw_step01_meet_your_claw.py | Remove redundant azure-identity from PEP 723 header list. |
| python/samples/02-agents/harness/build_your_own_claw/claw_step02_working_with_data.py | Remove redundant azure-identity from PEP 723 header list. |
| python/samples/02-agents/harness/build_your_own_claw/claw_step03_scaling_capabilities.py | Switch Monty/shell imports to lazy namespaces and remove redundant dependency header entry. |
| python/samples/02-agents/devui/README.md | Add DevUI CU sample entries to the DevUI index. |
| python/samples/02-agents/devui/agent_content_understanding/README.md | Update DevUI run command to new sample path. |
| python/samples/02-agents/devui/agent_content_understanding/agent.py | Update DevUI run command and use async Azure CLI credential import. |
| python/samples/02-agents/devui/agent_content_understanding/init.py | Add type-checker ignore comment on agent import. |
| python/samples/02-agents/devui/agent_content_understanding_file_search_foundry/README.md | Update cross-linking and DevUI run command paths. |
| python/samples/02-agents/devui/agent_content_understanding_file_search_foundry/agent.py | Update cross-linking and adjust CU credential handling for async path. |
| python/samples/02-agents/devui/agent_content_understanding_file_search_foundry/init.py | Add package marker file for sample module. |
| python/samples/02-agents/devui/agent_content_understanding_file_search_azure_openai/README.md | Update DevUI run command and section naming. |
| python/samples/02-agents/devui/agent_content_understanding_file_search_azure_openai/agent.py | Update DevUI run command and add type-checker ignore for OpenAI client getter. |
| python/samples/02-agents/devui/agent_content_understanding_file_search_azure_openai/init.py | Add type-checker ignore comment on agent import. |
| python/samples/02-agents/context_providers/README.md | Add CU context provider sample entry. |
| python/samples/02-agents/context_providers/code_act/README.md | Update Monty lifecycle wording and install guidance. |
| python/samples/02-agents/context_providers/code_act/monty_code_act.py | Switch import to agent_framework.monty and update doc guidance. |
| python/samples/02-agents/context_providers/azure_content_understanding/README.md | Add new CU context provider sample README under root samples tree. |
| python/samples/02-agents/context_providers/azure_content_understanding/01_document_qa.py | Update run path, asset pathing, and switch to async Azure CLI credential usage. |
| python/samples/02-agents/context_providers/azure_content_understanding/02_multi_turn_session.py | Update run path, asset pathing, and switch to async Azure CLI credential usage. |
| python/samples/02-agents/context_providers/azure_content_understanding/03_multimodal_chat.py | Update run path, asset pathing, and switch to async Azure CLI credential usage. |
| python/samples/02-agents/context_providers/azure_content_understanding/04_invoice_processing.py | Update run path, asset pathing, and switch to async Azure CLI credential usage. |
| python/samples/02-agents/context_providers/azure_content_understanding/05_large_doc_file_search.py | Update run path, asset pathing, and ensure credential/provider are entered in async context. |
| python/packages/core/pyproject.toml | Bump core to 1.12.0 and include newly promoted packages in all. |
| python/packages/core/agent_framework/tools/init.py | Add lazy-loaded agent_framework.tools namespace for agent-framework-tools. |
| python/packages/core/agent_framework/tools/init.pyi | Add typing stub for agent_framework.tools re-exports. |
| python/packages/core/agent_framework/monty/init.py | Add lazy-loaded agent_framework.monty namespace for agent-framework-monty. |
| python/packages/core/agent_framework/monty/init.pyi | Add typing stub for agent_framework.monty re-exports. |
| python/packages/core/agent_framework/mistral/init.py | Add lazy-loaded agent_framework.mistral namespace for agent-framework-mistral. |
| python/packages/core/agent_framework/mistral/init.pyi | Add typing stub for agent_framework.mistral re-exports. |
| python/packages/core/agent_framework/gemini/init.py | Add lazy-loaded agent_framework.gemini namespace for agent-framework-gemini. |
| python/packages/core/agent_framework/gemini/init.pyi | Add typing stub for agent_framework.gemini re-exports. |
| python/packages/core/agent_framework/foundry/init.py | Extend Foundry namespace to include hosting symbols from agent-framework-foundry-hosting. |
| python/packages/core/agent_framework/foundry/init.pyi | Extend Foundry namespace typing stub with hosting symbols. |
| python/packages/core/tests/core/test_foundry_namespace.py | Assert Foundry namespace exposes ResponsesHostServer. |
| python/packages/core/tests/core/test_tools_namespace.py | Add tests for tools lazy namespace behavior and error messages. |
| python/packages/core/tests/core/test_monty_namespace.py | Add tests for monty lazy namespace behavior and error messages. |
| python/packages/core/tests/core/test_mistral_namespace.py | Add tests for mistral lazy namespace behavior and error messages. |
| python/packages/core/tests/core/test_gemini_namespace.py | Add tests for gemini lazy namespace behavior and error messages. |
| python/packages/gemini/agent_framework_gemini/_chat_client.py | Adjust typing/casting around generate_content_stream to satisfy type checking. |
| python/packages/tools/pyproject.toml | Bump tools package version and lifecycle classifier to beta. |
| python/packages/tools/README.md | Update tools package lifecycle wording and switch examples to agent_framework.tools. |
| python/packages/monty/pyproject.toml | Bump Monty package version and lifecycle classifier to beta. |
| python/packages/monty/README.md | Update Monty lifecycle wording and switch examples to agent_framework.monty. |
| python/packages/monty/AGENTS.md | Update Monty package docs to reference lazy-loaded namespace. |
| python/packages/mistral/pyproject.toml | Bump Mistral package version and lifecycle classifier to beta. |
| python/packages/mistral/README.md | Link to relocated root sample and switch example import to agent_framework.mistral. |
| python/packages/mistral/AGENTS.md | Switch documented import path to agent_framework.mistral. |
| python/packages/mistral/samples/init.py | Remove package-local samples package marker as samples are relocated. |
| python/packages/gemini/pyproject.toml | Bump Gemini package version/lifecycle to beta and update google-genai bound. |
| python/packages/gemini/README.md | Update sample link to relocated root samples tree. |
| python/packages/gemini/AGENTS.md | Switch documented import path to agent_framework.gemini. |
| python/packages/gemini/samples/init.py | Remove package-local samples package marker as samples are relocated. |
| python/packages/foundry_hosting/pyproject.toml | Bump Foundry Hosting package version/lifecycle to beta. |
| python/packages/foundry_hosting/agent_framework_foundry_hosting/_toolbox.py | Update sample snippet imports to use agent_framework.foundry consolidated namespace. |
| python/packages/azure-contentunderstanding/pyproject.toml | Bump CU package version/lifecycle to beta. |
| python/packages/azure-contentunderstanding/README.md | Update sample links to relocated root sample tree. |
| python/packages/azure-contentunderstanding/AGENTS.md | Update sample path references to relocated root sample tree. |
| python/packages/azure-contentunderstanding/samples/README.md | Remove package-local sample index as samples are relocated. |
| python/packages/devui/pyproject.toml | Bump version and update openai lower bound. |
| python/packages/orchestrations/pyproject.toml | Bump orchestrations version. |
| python/packages/foundry/pyproject.toml | Bump Foundry package version. |
| python/packages/openai/pyproject.toml | Bump OpenAI integration package version. |
| python/packages/hosting/pyproject.toml | Bump hosting helper package version. |
| python/packages/hosting-a2a/pyproject.toml | Bump hosting-a2a helper package version and align hosting pin. |
| python/packages/hosting-mcp/pyproject.toml | Bump hosting-mcp helper package version and align hosting pin. |
| python/packages/hosting-responses/pyproject.toml | Bump hosting-responses helper package version and align hosting pin. |
| python/packages/hosting-telegram/pyproject.toml | Bump hosting-telegram helper package version and align hosting pin. |
| python/packages/azurefunctions/pyproject.toml | Bump azurefunctions package version and align durabletask lower bound. |
| python/packages/azure-ai-search/pyproject.toml | Bump Azure AI Search integration package version. |
| python/packages/azure-cosmos/pyproject.toml | Bump Azure Cosmos integration package version. |
| python/packages/azure-cosmos-memory/pyproject.toml | Bump Azure Cosmos memory integration package version. |
| python/packages/redis/pyproject.toml | Bump Redis integration package version. |
| python/packages/purview/pyproject.toml | Bump Purview integration package version. |
| python/packages/ollama/pyproject.toml | Bump Ollama integration package version. |
| python/packages/lab/pyproject.toml | Bump lab package version. |
| python/packages/hyperlight/pyproject.toml | Bump Hyperlight integration package version. |
| python/packages/mem0/pyproject.toml | Bump mem0 integration package version. |
| python/packages/a2a/pyproject.toml | Bump A2A integration package version. |
| python/packages/ag-ui/pyproject.toml | Bump AG-UI package version (rc8→rc9). |
| python/packages/anthropic/pyproject.toml | Bump Anthropic integration package version. |
| python/packages/bedrock/pyproject.toml | Bump Bedrock integration package version. |
| python/packages/chatkit/pyproject.toml | Bump ChatKit integration package version. |
| python/packages/claude/pyproject.toml | Bump Claude integration package version. |
| python/packages/copilotstudio/pyproject.toml | Bump Copilot Studio integration package version. |
| python/packages/github_copilot/pyproject.toml | Bump GitHub Copilot integration package version (rc3→rc4). |
| python/packages/foundry_local/pyproject.toml | Bump Foundry Local integration package version. |
Include the breaking Hosting Responses conversation ID helper changes from microsoft#7234 in the Python 1.12.0 changelog. Copilot-Session: 2dd9980a-b869-4c16-8642-75b7a6d6ebdf
Motivation & Context
Prepare the Python 1.12.0 release with package versions and dependency metadata aligned to the changes shipping in this cycle. This also advances the requested package lifecycle promotions and makes their public interfaces and samples available through the standard root package structure.
Description & Review Guide
agent_framework.*namespaces, and keeps sample installation and credential patterns aligned with supported package boundaries.Related Issue
No issue was created for this release PR.
Contribution Checklist
breaking changelabel (or add "[BREAKING]" to the title prefix, before or after any language prefix) — a workflow keeps the label and title prefix in sync automatically.