Releases: microsoft/agent-framework
python-1.2.0
[1.2.0] - 2026-04-24
Added
- agent-framework-core: Add functional workflow API (#4238)
- agent-framework-core, agent-framework-github-copilot: Add OpenTelemetry integration for
GitHubCopilotAgent(#5142) - agent-framework-a2a: Add Agent Framework to A2A bridge support (#2403)
- agent-framework-foundry: Surface
oauth_consent_requestevents from Responses API in Foundry clients (#5070)
Changed
- agent-framework-core, agent-framework-foundry: Update
FoundryAgentfor hosted agent sessions (#5447) - agent-framework-foundry-hosting: Upgrade hosting server dependency and add more type support (#5459)
Fixed
- agent-framework-ag-ui: Fix reasoning role and multimodal media parsing to follow specification (#5389)
- agent-framework-foundry: Stop emitting
[TOOLBOXES]warning for everyFoundryChatClientcall (#5440) - agent-framework-anthropic, agent-framework-azure-ai-search, agent-framework-azure-cosmos: Fix user agent prefix (#5455)
Full Changelog: python-1.1.1...python-1.2.0
dotnet-1.3.0
What's Changed
- .NET: Add dynamic tool expansion sample by @westey-m in #5425
- .NET: Update Aspire package to be preview by @westey-m in #5444
- .NET: Fix off-thread RunStatus race where GetStatusAsync can return Running after ResumeAsync halts by @peibekwe in #5412
- .NET: Update versions for release by @westey-m in #5449
- .NET: Add streaming support to A2A agent handler by @SergeyMenshykh in #5427
- .NET: dotnet: Add server-side Foundry Toolbox support and fix SDK beta.4 br… by @alliscode in #5450
Full Changelog: dotnet-1.2.0...dotnet-1.3.0
python-1.1.1
[1.1.1] - 2026-04-23
Added
- agent-framework-core: Add
expected_outputground-truth support toevaluate_workflowfor similarity evaluators (#5234) - agent-framework-ag-ui, agent-framework-a2a: Propagate
thread_idandforwarded_propsthrough AG-UI to A2Acontext_id(#5383) - samples: Add second approval-required tool (
set_stop_loss) toconcurrent_builder_tool_approvalsample (#4875) - agent-framework-core: Add
SKIP_PARSINGsentinel forFunctionTool.invoketo bypassContent-wrapping and return raw function results (#5424)
Changed
- agent-framework-foundry-hosting: Correct Development Status classifier from Beta (4) to Alpha (3) to match the package's lifecycle stage (#5387)
- tests: Add Python flaky test report workflow (#5342)
- agent-framework-hyperlight: Simplify host callback to pass raw Python results via
SKIP_PARSING, switchexecute_codeinput schema to a plain JSON-schema dict, and tighten public API
surface (#5424)
Fixed
- agent-framework-openai: Fix OpenAI Responses streaming to propagate
created_atfrom the finalresponse.completedevent (#5382) - agent-framework-openai: Fix
OpenAIEmbeddingClientto useAsyncOpenAIfor/openai/v1endpoints (#5137) - agent-framework-openai: Exclude null
file_idfrominput_imagepayload to prevent schema 400 errors (#5125) - agent-framework-foundry: Reconcile Toolbox hosted-tool payloads with the Responses API (#5414)
- agent-framework-ag-ui: Pass client
thread_idassession_idwhen constructingAgentSession(#5384) - agent-framework-hyperlight: Thread-confine
WasmSandboxinteractions via per-entryThreadPoolExecutorto eliminate the PyO3unsendablepanic when touched from asyncio worker threads
(#5424)
Full Changelog: python-1.1.0...python-1.1.1
python-1.1.0
[1.1.0] - 2026-04-21
Added
- agent-framework-gemini: Add
GeminiChatClient(#4847) - agent-framework-core: Add
context_providersanddescriptiontoworkflow.as_agent()(#4651) - agent-framework-core: Add experimental file history provider (#5248)
- agent-framework-core: Add OpenAI types to the default checkpoint encoding allow list (#5297)
- agent-framework-core: Add
AgentExecutorResponse.with_text()to preserve conversation history through custom executors (#5255) - agent-framework-a2a: Propagate A2A metadata from
Message,Artifact,Task, and event types (#5256) - agent-framework-core: Add
finish_reasonsupport toAgentResponseandAgentResponseUpdate(#5211) - agent-framework-hyperlight: Add Hyperlight CodeAct package and docs (#5185)
- agent-framework-openai: Add search tool content support for OpenAI responses (#5302)
- agent-framework-foundry: Add support for Foundry Toolboxes (#5346)
- agent-framework-ag-ui: Expose
forwardedPropsto agents and tools via session metadata (#5264) - agent-framework-foundry: Add hosted agent V2 support (#5379)
Changed
- agent-framework-azure-cosmos: [BREAKING]
CosmosCheckpointStoragenow uses restricted pickle deserialization by default, matchingFileCheckpointStoragebehavior. If your checkpoints contain application-defined types, pass them viaallowed_checkpoint_types=["my_app.models:MyState"]. (#5200) - agent-framework-core: Improve skill name validation (#4530)
- agent-framework-azure-cosmos: Add
allowed_checkpoint_typessupport toCosmosCheckpointStoragefor parity withFileCheckpointStorage(#5202) - agent-framework-core: Move
InMemoryhistory provider injection to first invocation (#5236) - agent-framework-github-copilot: Forward provider config to
SessionConfiginGitHubCopilotAgent(#5195) - agent-framework-hyperlight-codeact: Flatten
execute_codeoutput (#5333) - dependencies: Bump
pygmentsfrom2.19.2to2.20.0in/python(#4978) - tests: Bump misc integration retry delay to 30s (#5293)
- tests: Improve misc integration test robustness (#5295)
- tests: Skip hosted tools test on transient upstream MCP errors (#5296)
Fixed
- agent-framework-core: Fix
python-feature-lifecycleskill YAML frontmatter (#5226) - agent-framework-core: Fix
HandoffBuilderdropping function-level middleware when cloning agents (#5220) - agent-framework-ag-ui: Fix deterministic state updates from tool results (#5201)
- agent-framework-devui: Fix streaming memory growth and add cross-platform regression coverage (#5221)
- agent-framework-core: Skip
get_final_responsein_finalize_streamwhen the stream has errored (#5232) - agent-framework-openai: Fix reasoning replay when
store=False(#5250) - agent-framework-foundry: Handle
url_citationannotations inFoundryChatClientstreaming responses (#5071) - agent-framework-gemini: Fix Gemini client support for Gemini API and Vertex AI (#5258)
- agent-framework-copilotstudio: Fix
CopilotStudioAgentto reuse conversation ID from an existing session (#5299)
Full Changelog: python-1.0.1...python-1.1.0
dotnet-1.2.0
Changes:
- f2b215a .NET [WIP] Foundry Hosted Agents Support (#5312) [ #5091, #5287, #5278, #5281, #5316, #5336, #5341, #5367, #5368, #5371, #5374, #5406, #5408 ]
- 57fa8ea Python: Fix OpenAIEmbeddingClient to use AsyncOpenAI for /openai/v1 endpoints (#5137) [ #5068 ]
- aa582d0 Python: feat(evals): add ground_truth support for similarity evaluator (#5234)
- 8f17067 .NET: Update .NET package version 1.2.0 (#5364)
- 267351b .NET: Expand Workflow Unit Test Coverage (#5390)
- adcd2d3 .NET: Declarative workflows - Gracefully handle agent scenarios when no response is returned (#5376)
- d5777bc fix: Duplicate CallIds cause Handoff Message Filtering to fail (#5359)
- b6b191a Python: Add second approval-required tool (set_stop_loss) to concurrent_builder_tool_approval sample (#4875) [ #4874 ]
- 2c80367 Python: Bump versions for a release. Update CHANGELOG (#5385)
- ce8b630 Python: Foundry hosted agent V2 (#5379) [ #5177, #5215, #5235, #5261, #5281, #5284, #5298, #5372, #5378 ]
See More
- 07f4c8a Python: Expose forwardedProps to agents and tools via session metadata (#5264) [ #5239 ]
- 04aaf0c Python: Add support for Foundry Toolboxes (#5346)
- 3e54a68 Python: Add search tool content for OpenAI responses (#5302)
- 60af59b .NET: Features/3768-devui-aspire-integration (#3771)
- 69894ed Python: Flatten hyperlight execute_code output (#5333)
- 495e1da Python: Fix CopilotStudioAgent to reuse conversation ID from existing session (#5299) [ #5285 ]
- 5777ed2 .NET: fix: Add session support for Handoff-hosted Agents (#5280)
- 52303a8 .NET: Add Code Interpreter container file download samples (#5014) [ #3081 ]
- c85d24d .NET: Fix declarative resume edge predicates to recognize both direct and PortableValue-wrapped forms after checkpoint restore (#5323)
- b03cb32 Python: Add Hyperlight CodeAct package and docs (#5185)
- dbf935b .NET: fix: Foundry Agents without description in Handoff (#5311)
- ca580a8 .NET: Add error checking to workflow samples (#5175)
- 101e07b .NET: Add Handoff sample (#5245)
- aee1acb .NET: Foundry Evals integration for .NET (#4914) [ #5269 ]
- 91e3435 Python: Feat: Add finish_reason support to AgentResponse and AgentResponseUpdate (#5211) [ #4622 ]
- 90a6339 Python: Fix Gemini client support for Gemini API and Vertex AI (#5258)
- c14beed test: Add Handoff composability test (#5208)
- 43d9897 fix: propagate A2A metadata with namespaced key in additional_properties (#5240) (#5256)
- 60da0ff .NET: Improve local release build perf by only formatting for one build target framework (#5266)
- a204482 .NET: Update Microsoft.Extensions.AI to 10.5.0 and OpenAI to 2.10.0 and remove unused refs (#5269)
- 435c66e Python: Handle url_citation annotations in
FoundryChatClientstreaming responses (#5071) [ #5029 ] - 52d50be Bump Anthropic SDK to 12.13.0 and Anthropic.Foundry to 0.5.0 (#5279)
- d20f9b5 Add AgentExecutorResponse.with_text() to preserve conversation history through custom executors (#5255) [ #5246 ]
- 87a8fa2 .NET: Fix intermittent checkpoint-restore race in in-process workflow runs (#5134)
- 8f7fd95 Python: Add OpenAI types to default checkpoint encoding allow list (#5297)
- 6969706 Python: Add context_providers and description to
workflow.as_agent()(#4651) - fe4cd3c Revert to public MCP server and skip on transient upstream errors (#5296)
- 611230c Python: improve misc-integration test robustness (#5295)
- f112150 Python: bump misc-integration retry delay to 30s (#5293)
- ff05c22 Python: add experimental file history provider (#5248)
- eab7f09 Forward provider config to SessionConfig in GitHubCopilotAgent (fixes #5190) (#5195)
- 68b9364 Python: Bump agent-framework-devui to 1.0.0b260414 for release (#5259)
- 2b251d9 Python: Fix reasoning replay when store=False (#5250)
- 485af07 Python: Add GeminiChatClient (#4847)
- 64c68ca Python: Skip get_final_response in OTel _finalize_stream when stream errored (#5232) [ #5231 ]
- 98e1776 Python: Fix DevUI streaming memory growth and add cross-platform regression coverage (#5221)
- 7bb0fec Python: Move InMemory history provider injection to the first invocation (#5236)
- f183f88 Python: AG-UI deterministic state updates from tool results (#5201)
- 3c31ac2 Python: Fix HandoffBuilder dropping function-level middleware when cloning agents (#5220) [ #5173 ]
- 1b95e85 Python: Add
allowed_checkpoint_typessupport toCosmosCheckpointStoragefor parity withFileCheckpointStorage(#5202) [ #5200, #3 ] - b89adb2 Python: skill name validation improvements (#4530)
- 9133974 Bump pygments from 2.19.2 to 2.20.0 in /python (#4978)
- 952e685 Python: Fix python-feature-lifecycle skill YAML frontmatter (#5226)
- b1fb63e .NET: Update AGUI service to support session storage (#5193)
- 76fe731 .NET: feat: Refactor Handoff Orchestration and add HITL support (#5174)
- 39b560f Add missing path to verify-samples run checkout (#5194)
This list of changes was auto generated.
python-devui-1.0.0b260414
[devui-1.0.0b260414] - 2026-04-14
Fixed
- agent-framework-devui: Fix streaming memory growth in DevUI frontend (#5221)
python-1.0.1
1.0.1 - 2026-04-09
Important
Security hardening for FileCheckpointStorage: Checkpoint deserialization now flows through a restricted unpickler by default, which only permits a built-in set of safe Python types and all agent_framework framework types. If your application stores custom types in checkpoints, pass their "module:qualname" identifiers via the new allowed_checkpoint_types constructor parameter — otherwise loads will raise WorkflowCheckpointException. See Security Considerations for details and the opt-in format.
Added
- samples: Add sample documentation for two separate Neo4j context providers for retrieval and memory (#4010)
- agent-framework-azure-cosmos: Add Cosmos DB NoSQL checkpoint storage for Python workflows (#4916)
Changed
- docs: Remove pre-release flag from agent-framework installation instructions (#5082)
- samples: Revise agent examples in
README.md(#5067) - repo: Update
CHANGELOGwith v1.0.0 release (#5069) - agent-framework-core: [BREAKING] Fix handoff workflow context management and improve AG-UI demo (#5136)
- agent-framework-core: Restrict persisted checkpoint deserialization by default (#4941)
- samples: Bump
vitefrom 7.3.1 to 7.3.2 in/python/samples/05-end-to-end/ag_ui_workflow_handoff/frontend(#5132) - python: Bump
cryptographyfrom 46.0.6 to 46.0.7 (#5176) - python: Bump
mcpfrom 1.26.0 to 1.27.0 (#5117) - python: Bump
mcp[ws]from 1.26.0 to 1.27.0 (#5119)
Fixed
- agent-framework-core: Raise clear handler registration error for unresolved
TypeVarannotations (#4944) - agent-framework-openai: Fix
response_formatcrash on background polling with empty text (#5146) - agent-framework-foundry: Strip tools from
FoundryAgentrequest whenagent_referenceis present (#5101) - agent-framework-core: Fix test compatibility for entity key validation (#5179)
- agent-framework-openai: Stop emitting duplicate reasoning content from
response.reasoning_text.doneandresponse.reasoning_summary_text.doneevents (#5162)
Full Changelog: python-1.0.0...python-1.0.1
dotnet-1.1.0
Changes:
- 3e864cd .NET: Update version to 1.1.0 (#5204)
- 14d2ab3 Standardize file skills terminology on 'directory' (#5205)
- e5f7b9c .NET: Support reflection for discovery of resources and scripts in class-based skills (#5183)
See More
- 1dd828d CHANGELOG Update with V1.0.0 Release (#5069)
- 8348584 VerifySamples: Filter projects to net10 only (#5184)
- 6d6cb84 .NET: Improve resilience of verify-samples by building separately and improving evaluation instructions (#5151)
- 79afda1 Samples fixes (#5169)
- a7a02c1 Fix test compat for entity key validation (#5179)
- 7010dd7 .NET: Support custom types in skill resource and script functions (#5152)
- e10d448 Fix handoff workflow context management and improve AG-UI demo (#5136)
- 942cb04 .NET: Fix compaction chat history duplication bug (#5149)
- e224f06 .NET: Update models used in dotnet samples to gpt-5.4-mini (#5080)
- 826d8db .NET: fix: Concurrent Workflow Sample (#5090)
- 4134c74 Add CreateSessionAsync(conversationId) to FoundryAgent (#5144) [ #5138 ]
- 86b49d8 Fix and simplify ComputerUse sample (#5075)
- d73c06f .NET: Align skill folder discovery with spec (#5078)
- 746c7da Revise agent examples in README.md (#5067)
- d30103f .NET: Fix input signal issue during checkpoint restoration (#5085)
- 55ae57c .NET: Add Message Delivery Callback Overloads to Executor (#5081)
- d284d96 fix: 04_MultiModelService sample (#5074)
- d1a8115 Bump Anthropic from 12.8.0 to 12.11.0 (#5055)
- 9f0dbe5 .NET: Improve workflow unit test coverage (#5072)
- 3fc1d00 .NET: skill as class (#5027)
- e4defad .NET: Add github actions workflow for verify-samples (#5034)
This list of changes was auto generated.
python-1.0.0
[1.0.0] - 2026-04-02
Important
For any breaking changes & updates, please view this migration guide.
Added
- repo: Add
PACKAGE_STATUS.mdto track lifecycle status of all Python packages (#5062)
Changed
- agent-framework, agent-framework-core, agent-framework-openai, agent-framework-foundry: [BREAKING] Promote from
1.0.0rc6to1.0.0(Production/Stable) (#5062) - agent-framework-core, agent-framework-openai, agent-framework-foundry: [BREAKING] Dependency floors now require released
>=1.0.0,<2packages, breaking compatibility with older RC installs (#5062) - agent-framework-a2a, agent-framework-ag-ui, agent-framework-anthropic, agent-framework-azure-ai-search, agent-framework-azure-cosmos, agent-framework-azurefunctions, agent-framework-bedrock, agent-framework-chatkit, agent-framework-claude, agent-framework-copilotstudio, agent-framework-declarative, agent-framework-devui, agent-framework-durabletask, agent-framework-foundry-local, agent-framework-github-copilot, agent-framework-lab, agent-framework-mem0, agent-framework-ollama, agent-framework-orchestrations, agent-framework-purview, agent-framework-redis: Bump beta versions from
1.0.0b260330to1.0.0b260402(#5062) - docs: Update install instructions to drop
--preflag for released packages (#5062)
Removed
- agent-framework-core: [BREAKING] Remove deprecated
BaseContextProviderandBaseHistoryProvideraliases (#5062) - agent-framework-core: [BREAKING] Remove deprecated
textparameter fromMessageconstructor (#5062)
Fixed
- agent-framework-core, agent-framework-openai, agent-framework-foundry, agent-framework-azurefunctions, agent-framework-devui, agent-framework-orchestrations, agent-framework-azure-ai-search: Migrate message construction from
Message(text=...)toMessage(contents=[...])throughout codebase (#5062) - agent-framework-devui: Accept legacy payload formats (
text,message,content,input,data) and convert to framework-nativeMessage(contents=...)(#5062) - samples: Fix Foundry samples to use env vars consistently and update install guidance (#5062)
dotnet-1.0.0
Changes:
- c798cb7 release: Mark Handoff Orchestrations Experimental (#5065)
- 524c021 .NET: Update release versions (#5059)
- 281661e .NET: Remove timeout from InputWait in OffThread execution (#4996)
- b0613a8 .NET: Bump Azure.AI.Projects to 2.0.0 GA (#5060)
- 79b3804 fix: Update Google.GenAI to verison compatible with M.E.AI 10.4.0+ (#5061)
- a356a16 .NET: Remove OpenAIAssistantClientExtensions class (#5058)
See More
- 628bb1a .NET: Rename Microsoft.Agents.AI.AzureAI to Microsoft.Agents.AI.Foundry and consolidate FoundryMemory (#5042)
- 15e435b Fix telemetry sample bug (#5037)
- 38de991 .NET: Fix RequestInfoEvent lost when resuming workflow from checkpoint (#4955)
- 25696a7 .NET: Replace Azure Foundry/Azure AI Foundry with Microsoft Foundry in .NET samples (#5032)
- 2cb78ea fix and unify devui samples (#5025)
- acaadc9 .NET: Add a verify-samples tool and skill (#5005)
- 3432984 Add Neo4j GraphRAG samples (#4994)
- 2a8c3e2 fixes to azure ai search init, samples (#5021)
- 9c9d81d .NET: Improve README: architecture overview, troubleshooting, and sample links (#5002)
- 47a8a30 Fix environment variable set statement in py DEV_SETUP (#5006)
- 6e7254b .NET: [BREAKING] Rename from ServiceStoredSimulatingChatClient to PerServiceCallChatHistoryPersistingChatClient (#4993)
- 3d09337 Update project name from 'Semantic Kernel' to 'Agent Framework' (#5001)
- 3c727b5 Improve CONTRIBUTING.md with dev setup links and docs guidance (#5000)
- 3f964c4 Removing old code-gen docs from dotnet root (#4997)
This list of changes was auto generated.