Python: [BREAKING] update to v1.0.0#5062
Merged
eavanvalkenburg merged 3 commits intomicrosoft:mainfrom Apr 2, 2026
Merged
Conversation
Contributor
Contributor
There was a problem hiding this comment.
Pull request overview
This PR finalizes the Python v1.0.0 release by updating package versions/metadata, completing the Message API migration (from text= to contents=), removing deprecated aliases, and aligning docs/samples/scripts with the GA surface.
Changes:
- Promote core/openai/foundry/meta packages to
1.0.0and update other connectors’ dependency bounds toagent-framework-core>=1.0.0,<2. - Migrate samples/tests/scripts from
Message(text=...)toMessage(contents=[...])and remove deprecated provider aliases. - Update installation docs to drop
--prefor released packages and addpython/PACKAGE_STATUS.md.
Reviewed changes
Copilot reviewed 169 out of 170 changed files in this pull request and generated 3 comments.
Show a summary per file
| File | Description |
|---|---|
| python/scripts/sample_validation/create_dynamic_workflow_executor.py | Update Message construction to contents=[...]. |
| python/scripts/dependencies/upgrade_dev_dependencies.py | Add verbose logging support for dev-dependency pin upgrades. |
| python/scripts/dependencies/_dependency_bounds_upper_impl.py | Adjust dev-pin refresh to prefer configured version source (PyPI/lock) and add debug logs. |
| python/samples/semantic-kernel-migration/orchestrations/handoff.py | Update Message creation to contents=[...]. |
| python/samples/README.md | Remove --pre from released package install instructions. |
| python/samples/AGENTS.md | Remove --pre guidance for released packages and update wording. |
| python/samples/05-end-to-end/workflow_evaluation/create_workflow.py | Convert prompts to contents=[...]. |
| python/samples/05-end-to-end/purview_agent/sample_purview_agent.py | Convert user messages to contents=[...]. |
| python/samples/05-end-to-end/hosted_agents/agent_with_text_search_rag/main.py | Convert context-injected message to contents=[...]. |
| python/samples/05-end-to-end/evaluation/red_teaming/red_team_agent_sample.py | Convert message mapping to contents=[...]. |
| python/samples/05-end-to-end/chatkit-integration/app.py | Convert prompts to contents=[...] for agent messaging. |
| python/samples/04-hosting/azure_functions/12_workflow_hitl/function_app.py | Convert request messages to contents=[...]. |
| python/samples/04-hosting/azure_functions/09_workflow_shared_state/function_app.py | Convert workflow forwarded messages to contents=[...]. |
| python/samples/03-workflows/visualization/concurrent_with_visualization.py | Convert message initialization to contents=[...]. |
| python/samples/03-workflows/state-management/state_with_agents.py | Convert workflow messages to contents=[...]. |
| python/samples/03-workflows/parallelism/fan_out_fan_in_edges.py | Convert message initialization to contents=[...]. |
| python/samples/03-workflows/orchestrations/concurrent_custom_aggregator.py | Convert system/user messages to contents=[...]. |
| python/samples/03-workflows/human-in-the-loop/guessing_game_with_human_input.py | Convert HITL prompt messages to contents=[...]. |
| python/samples/03-workflows/human-in-the-loop/concurrent_request_info.py | Convert system/user messages to contents=[...]. |
| python/samples/03-workflows/human-in-the-loop/agents_with_HITL.py | Convert appended feedback messages to contents=[...]. |
| python/samples/03-workflows/control-flow/switch_case_edge_group.py | Convert forwarded email messages to contents=[...]. |
| python/samples/03-workflows/control-flow/simple_loop.py | Convert loop prompt message to contents=[...]. |
| python/samples/03-workflows/control-flow/multi_selection_edge_group.py | Convert forwarded email messages to contents=[...]. |
| python/samples/03-workflows/control-flow/edge_condition.py | Convert bridge and start messages to contents=[...]. |
| python/samples/03-workflows/checkpoint/checkpoint_with_human_in_the_loop.py | Convert checkpointed workflow messages to contents=[...]. |
| python/samples/03-workflows/agents/workflow_as_agent_reflection_pattern.py | Convert system prompt to contents=[...]. |
| python/samples/03-workflows/agents/azure_chat_agents_tool_calls_with_feedback.py | Convert feedback messages to contents=[...]. |
| python/samples/02-agents/typed_options.py | Convert demo prompts to contents=[...]. |
| python/samples/02-agents/response_stream.py | Convert constructed response messages to contents=[...]. |
| python/samples/02-agents/providers/ollama/ollama_chat_client.py | Convert user prompt to contents=[...]. |
| python/samples/02-agents/providers/foundry/foundry_chat_client_code_interpreter_files.py | Update to Foundry client OpenAI accessor + wrap agent tool usage and cleanup in finally. |
| python/samples/02-agents/providers/foundry/foundry_agent_with_function_tools.py | Switch to env-based config and implicit tool wrapping; update typing to Annotated[..., \"...\"]. |
| python/samples/02-agents/providers/foundry/foundry_agent_with_env_vars.py | Remove redundant env-var sample (deleted). |
| python/samples/02-agents/providers/foundry/foundry_agent_hosted.py | Move Foundry config to env vars; load .env. |
| python/samples/02-agents/providers/foundry/foundry_agent_custom_client.py | Move Foundry config to env vars; load .env. |
| python/samples/02-agents/providers/azure/openai_client_with_session.py | Update Agent.run() store control to options={\"store\": ...}. |
| python/samples/02-agents/providers/anthropic/anthropic_advanced.py | Update client construction pattern and document env vars. |
| python/samples/02-agents/observability/configure_otel_providers_with_parameters.py | Convert prompts to contents=[...]. |
| python/samples/02-agents/observability/configure_otel_providers_with_env_var.py | Convert prompts to contents=[...]. |
| python/samples/02-agents/observability/advanced_zero_code.py | Convert prompts to contents=[...]. |
| python/samples/02-agents/observability/advanced_manual_setup_console_output.py | Convert prompt to contents=[...]. |
| python/samples/02-agents/middleware/override_result_with_middleware.py | Convert constructed messages to contents=[...]. |
| python/samples/02-agents/middleware/middleware_termination.py | Convert termination message to contents=[...]. |
| python/samples/02-agents/middleware/chat_middleware.py | Convert middleware rejection message to contents=[...]. |
| python/samples/02-agents/devui/agent_weather/agent.py | Convert blocked response messages to contents=[...]. |
| python/samples/02-agents/declarative/README.md | Remove --pre from released connector install instructions. |
| python/samples/02-agents/declarative/openai_agent.py | Reformat YAML path for readability. |
| python/samples/02-agents/declarative/microsoft_learn_agent.py | Reformat YAML path for readability. |
| python/samples/02-agents/declarative/get_weather_agent.py | Reformat YAML path for readability. |
| python/samples/02-agents/declarative/azure_openai_responses_agent.py | Reformat YAML path for readability. |
| python/samples/02-agents/conversations/README.md | Update provider base type naming in docs. |
| python/samples/02-agents/context_providers/README.md | Update provider base type naming in docs. |
| python/samples/02-agents/compaction/tiktoken_tokenizer.py | Convert sample conversation to contents=[...]. |
| python/samples/02-agents/compaction/custom.py | Convert sample conversation to contents=[...]. |
| python/samples/02-agents/compaction/basics.py | Convert sample conversation and summary message to contents=[...]. |
| python/samples/02-agents/compaction/agent_client_overrides.py | Convert sample conversation and responses to contents=[...]. |
| python/samples/02-agents/compaction/advanced.py | Convert sample history and summary message to contents=[...]. |
| python/samples/02-agents/chat_client/custom_chat_client.py | Convert user/assistant messages to contents=[...]. |
| python/samples/02-agents/chat_client/chat_response_cancellation.py | Convert prompt message to contents=[...]. |
| python/samples/02-agents/chat_client/built_in_chat_clients.py | Convert prompt message to contents=[...]. |
| python/samples/01-get-started/README.md | Remove --pre from released package install instructions. |
| python/README.md | Update install guidance: drop --pre for released packages; keep it for preview connectors. |
| python/pyproject.toml | Set meta package to 1.0.0, update dev tooling pins, and adjust upgrade-dev-dependencies sequence. |
| python/packages/redis/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/redis/agent_framework_redis/_context_provider.py | Convert injected message to contents=[...]. |
| python/packages/purview/tests/purview/test_processor.py | Update tests to use Message(contents=[...]). |
| python/packages/purview/pyproject.toml | Update version, classifier, and core dependency bounds. |
| python/packages/purview/agent_framework_purview/_middleware.py | Convert blocked-policy messages to contents=[...] and reduce duplication. |
| python/packages/orchestrations/tests/test_orchestration_request_info.py | Update tests to contents=[...]. |
| python/packages/orchestrations/tests/test_magentic.py | Update captured messages to contents=[...]. |
| python/packages/orchestrations/tests/test_handoff.py | Update HITL response messages to contents=[...]. |
| python/packages/orchestrations/tests/test_group_chat.py | Update messages in tests to contents=[...]. |
| python/packages/orchestrations/tests/test_concurrent.py | Update test executor responses to contents=[...]. |
| python/packages/orchestrations/pyproject.toml | Update version and core dependency bounds. |
| python/packages/orchestrations/agent_framework_orchestrations/_orchestrator_helpers.py | Convert cleaned/utility messages to contents=[...]. |
| python/packages/orchestrations/agent_framework_orchestrations/_orchestration_request_info.py | Convert factory messages to contents=[...]. |
| python/packages/orchestrations/agent_framework_orchestrations/_magentic.py | Convert internal prompts and emitted messages to contents=[...]. |
| python/packages/orchestrations/agent_framework_orchestrations/_handoff.py | Convert generated user messages to contents=[...]. |
| python/packages/orchestrations/agent_framework_orchestrations/_group_chat.py | Convert instruction/error messages to contents=[...]. |
| python/packages/orchestrations/agent_framework_orchestrations/_base_group_chat_orchestrator.py | Convert task and completion messages to contents=[...]. |
| python/packages/openai/tests/openai/test_openai_chat_completion_client.py | Update tests to contents=[...]. |
| python/packages/openai/tests/openai/test_openai_chat_completion_client_base.py | Update tests to contents=[...]. |
| python/packages/openai/tests/openai/test_openai_chat_completion_client_azure.py | Update tests to contents=[...]. |
| python/packages/openai/tests/openai/test_openai_chat_client_azure.py | Update tests to contents=[...]. |
| python/packages/openai/README.md | Remove --pre from released package install instructions. |
| python/packages/openai/pyproject.toml | Promote to 1.0.0 and stable classifier; update core bounds. |
| python/packages/ollama/tests/test_ollama_chat_client.py | Update tests to contents=[...]. |
| python/packages/ollama/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/mem0/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/mem0/agent_framework_mem0/_context_provider.py | Convert injected message to contents=[...]. |
| python/packages/lab/tau2/agent_framework_lab_tau2/runner.py | Convert hardcoded greeting messages to contents=[...]. |
| python/packages/lab/pyproject.toml | Update version, core bounds, and dev tooling pins. |
| python/packages/github_copilot/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/foundry/tests/foundry/test_foundry_memory_provider.py | Update tests to contents=[...]. |
| python/packages/foundry/tests/foundry/test_foundry_chat_client.py | Update tests to contents=[...]. |
| python/packages/foundry/pyproject.toml | Promote to 1.0.0 and stable classifier; update dependency bounds. |
| python/packages/foundry/agent_framework_foundry/_memory_provider.py | Convert injected message to contents=[...]. |
| python/packages/foundry_local/pyproject.toml | Update version and dependency bounds for beta release. |
| python/packages/durabletask/tests/test_shim.py | Update tests to contents=[...]. |
| python/packages/durabletask/tests/test_durable_entities.py | Update test helper messages to contents=[...]. |
| python/packages/durabletask/pyproject.toml | Update version, core bounds, and types dependency pin. |
| python/packages/devui/samples/README.md | Remove relocated samples README (deleted). |
| python/packages/devui/samples/init.py | Remove relocated samples package init (deleted). |
| python/packages/devui/pyproject.toml | Update version, core bounds, and orchestrations beta pin. |
| python/packages/devui/agent_framework_devui/_utils.py | Add legacy payload parsing to map {role,text} into Message(contents=...). |
| python/packages/devui/agent_framework_devui/_conversations.py | Convert stored messages to contents=[...]. |
| python/packages/declarative/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/declarative/agent_framework_declarative/_workflows/_executors_tools.py | Convert rejection message to contents=[...]. |
| python/packages/declarative/agent_framework_declarative/_workflows/_executors_agents.py | Convert user/assistant message construction to contents=[...]. |
| python/packages/core/tests/workflow/test_workflow_kwargs.py | Update tests to contents=[...]. |
| python/packages/core/tests/workflow/test_workflow_builder.py | Update tests to contents=[...]. |
| python/packages/core/tests/workflow/test_workflow_agent.py | Update tests to contents=[...]. |
| python/packages/core/tests/workflow/test_full_conversation.py | Update tests to contents=[...]. |
| python/packages/core/tests/workflow/test_executor.py | Update tests to contents=[...]. |
| python/packages/core/tests/workflow/test_agent_run_event_typing.py | Update tests to contents=[...]. |
| python/packages/core/tests/workflow/test_agent_executor.py | Update tests to contents=[...]. |
| python/packages/core/tests/core/test_types.py | Update tests to reflect Message(contents=[...]) construction. |
| python/packages/core/tests/core/test_sessions.py | Remove deprecated alias tests; drop deprecated imports. |
| python/packages/core/tests/core/test_middleware_with_chat.py | Update tests/middleware message mutations to contents=[...]. |
| python/packages/core/tests/core/test_middleware_context_result.py | Update tests to contents=[...]. |
| python/packages/core/tests/core/test_clients.py | Update tests to contents=[...]. |
| python/packages/core/tests/core/test_as_tool_kwargs_propagation.py | Update tests to contents=[...]. |
| python/packages/core/tests/core/conftest.py | Update mock default messages to contents=[...]. |
| python/packages/core/README.md | Remove --pre from released package install instructions. |
| python/packages/core/pyproject.toml | Promote to 1.0.0 and stable classifier. |
| python/packages/core/AGENTS.md | Update examples to Message(contents=[...]). |
| python/packages/core/agent_framework/_workflows/_message_utils.py | Normalize strings/Content into Message(contents=[...]). |
| python/packages/core/agent_framework/_types.py | Remove Message(text=...) ctor arg; rely on contents and keep .text property. |
| python/packages/core/agent_framework/_sessions.py | Remove deprecated Base*Provider aliases. |
| python/packages/core/agent_framework/_serialization.py | Update serialization example to contents=[...]. |
| python/packages/core/agent_framework/_middleware.py | Update system prompt injection to contents=[...]. |
| python/packages/core/agent_framework/_compaction.py | Update summarization prompt messages to contents=[...]. |
| python/packages/core/agent_framework/_clients.py | Update docs/examples and response message creation to contents=[...]. |
| python/packages/core/agent_framework/init.py | Stop exporting deprecated Base*Provider aliases. |
| python/packages/copilotstudio/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/claude/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/chatkit/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/chatkit/agent_framework_chatkit/_converter.py | Convert built messages to contents=[...] and update comments. |
| python/packages/bedrock/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/azurefunctions/tests/test_workflow.py | Update tests to contents=[...]. |
| python/packages/azurefunctions/tests/test_orchestration.py | Update tests to contents=[...]. |
| python/packages/azurefunctions/tests/test_func_utils.py | Update serialization roundtrip tests to contents=[...]. |
| python/packages/azurefunctions/tests/test_entities.py | Update helper messages to contents=[...]. |
| python/packages/azurefunctions/tests/test_app.py | Update mocked responses to contents=[...]. |
| python/packages/azurefunctions/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/azurefunctions/agent_framework_azurefunctions/_workflow.py | Ensure response text is non-null and convert messages to contents=[...]. |
| python/packages/azure-cosmos/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/azure-ai-search/tests/test_aisearch_context_provider.py | Update tests to contents=[...]. |
| python/packages/azure-ai-search/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/azure-ai-search/agent_framework_azure_ai_search/_context_provider.py | Convert emitted/context messages to contents=[...]. |
| python/packages/anthropic/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/ag-ui/tests/ag_ui/test_ag_ui_client.py | Update tests to contents=[...]. |
| python/packages/ag-ui/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/packages/ag-ui/getting_started/client.py | Convert prompt message to contents=[...]. |
| python/packages/ag-ui/getting_started/client_advanced.py | Convert prompts to contents=[...] and reformat call sites. |
| python/packages/a2a/pyproject.toml | Update version and core dependency bounds for beta release. |
| python/PACKAGE_STATUS.md | Add workspace-wide package lifecycle/status tracking. |
| python/.github/skills/python-package-management/SKILL.md | Document package lifecycle stages, promotion path, and update requirements. |
python/samples/02-agents/providers/foundry/foundry_agent_with_function_tools.py
Show resolved
Hide resolved
westey-m
approved these changes
Apr 2, 2026
SergeyMenshykh
approved these changes
Apr 2, 2026
TaoChenOSU
approved these changes
Apr 2, 2026
alliscode
pushed a commit
to alliscode/agent-framework
that referenced
this pull request
Apr 3, 2026
* updates to final deprecated pieces and versions * fix mypy * fix readme links
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Motivation and Context
Updates Agent Framework to v1.0.0, for core, openai, foundry and the meta package.
Adds a package status md to the root to track status
Updated readme's with or without --pre in the install command
Also removed last deprecated pieces
Final fixes on samples
Closes: #5031
Description
Contribution Checklist