Releases: microsoft/agent-framework
Releases · microsoft/agent-framework
dotnet-1.5.0
What's Changed
- .NET: feat: Implement message filtering to exclude non-portable content typ… by @tarockey in #5410
- .NET: Add allow listing for WebBrowsingTool by @westey-m in #5605
- .NET: fix: JSON Serialization issue with MultiPartyConversation by @lokitoth in #5653
- .NET: Improve Todo multithreading and inject todos into message list by @westey-m in #5655
- .NET: fix: Add missing Workflows "Shared" sources to solution by @lokitoth in #5656
- .NET: Fix QuestionExecutor looping after GotoAction re-entry in declarative workflows by @peibekwe in #5635
- .NET: Fix YAML block scalar parsing for file skills by @tejakusireddy in #5610
- .NET: Add hosted agent observability sample by @rogerbarreto in #5660
- .NET: Bump MEAI to 10.5.1 and add Foundry per-call x-client header support by @rogerbarreto in #5652
- .NET: Fix flaky declarative test by @peibekwe in #5669
- .NET: Add Foundry.Hosting.IntegrationTests by @rogerbarreto in #5598
- .NET: Issue 5662 by @alliscode in #5668
- .NET: Support reasoning events in AGUI by @jeffinsibycoremont in #4953
- .NET: feat: Update Github Copilot SDK to 1.0.0-beta.2 by @lokitoth in #5699
- .NET: feat: Implement Magentic Orchestration for .NET by @lokitoth in #5595
- .NET: Foundry.Hosting IT - avoid MSB3026 in publish step by @rogerbarreto in #5689
- .NET: Python: Add dotnet integration test report to CI by @giles17 in #5515
- .NET: Non-thread-safe sequence number generation may cause duplicate or out-of-order IDs by @tuanaiseo in #5320
- .NET: Fix typo: sesionElement -> sessionElement by @XiongHaoTrigger in #5674
- .NET: Mark Magentic Orchestration Experimental by @lokitoth in #5704
- .NET: Fix function_call_output.output to be a JSON string on the wire by @alliscode in #5705
- .NET: Update version for release by @lokitoth in #5703
New Contributors
- @tarockey made their first contribution in #5410
- @tejakusireddy made their first contribution in #5610
- @jeffinsibycoremont made their first contribution in #4953
- @tuanaiseo made their first contribution in #5320
- @XiongHaoTrigger made their first contribution in #5674
Full Changelog: dotnet-1.4.0...dotnet-1.5.0
python-1.3.0
[1.3.0] - 2026-05-07
Added
- agent-framework-core: Add
ClassSkillfor class-based skill definitions with declarative metadata and automatic method discovery (#5678) - agent-framework-core: Add experimental session-mode harness context provider (#5611)
- agent-framework-core: Add experimental todo-list harness context provider (#5612)
- agent-framework-core: Add experimental memory harness context provider (#5613)
- agent-framework-core: Notify agent of external
AgentModeProvidermode changes (#5650) - agent-framework-core: Information-flow control prompt injection defense (#5331)
- agent-framework-openai: Support OpenAI and Gemini
allowed_toolstool choice (#5322) - agent-framework-openai: Support GPT-5 verbosity option and restore Foundry
agent_reference(#5619) - agent-framework-anthropic: Add
base_urlparameter toAnthropicClientandRawAnthropicClient(#5685) - agent-framework-foundry-hosting: Add support for function approval flow in Foundry hosted agent (#5666)
- agent-framework-declarative: Add Python parity for
InvokeMcpToolin declarative workflow (#5630) - agent-framework-declarative: Add Python parity for
HttpRequestActionin declarative workflow (#5599) - agent-framework-claude, agent-framework-github-copilot: Enforce
approval_modein Claude and GitHub Copilot agents (#5562) - agent-framework-github-copilot: Upgrade
github-copilot-sdkto v1.0.0b2 withinstruction_directories,copilot_home, and runtime options forwarding on session resume (#5665) - samples: Add hosted agent sample with observability (#5608)
- samples: Add sample for hosted agent with files (#5596)
Changed
- agent-framework-core: [BREAKING — experimental skills API] Restructure agent skills to use multi-source architecture (#5584)
- agent-framework-foundry: Remove bespoke Foundry toolbox helpers; standardize on MCP for toolbox consumption (#5671)
Fixed
- agent-framework-core: Fix
MCPStreamableHTTPToolleakingasyncio.CancelledErrorwhen MCP server is unreachable (#5687) - agent-framework-openai: Drop completed
continuation_tokenfrom shared options in tool loop (#5462) - agent-framework-bedrock: Don't send
toolChoicewhen no tools are configured (#5172) - agent-framework-hyperlight: Fix
WasmSandboxcross-thread Drop and harden hosted-agent sample (#5603) - agent-framework-devui: Fix incorrect workflow timings by adding
created_atto executor events (#5615) - agent-framework-foundry-hosting: Fix hosted MCP replay producing orphan
function_call_output(#5581)
dotnet-1.4.0
What's Changed
- .NET: Bump OpenTelemetry packages to 1.15.3 by @SergeyMenshykh in #5478
- .NET: Support returning durable workflow results from HTTP trigger endpoint by @kshyju in #5321
- .NET: [Breaking] Support string[] arguments for file-based skill scripts by @SergeyMenshykh in #5475
- .NET: Add HttpRequestAction support to declarative workflows by @peibekwe in #5474
- .NET: Add declarative HttpRequestAction sample by @peibekwe in #5572
- .NET: dotnet: Add hosted-agent User-Agent supplement to outgoing requests by @alliscode in #5453
- .NET: Add dedicated Foundry.Hosting UnitTest project by @rogerbarreto in #5592
- .NET: Harness Feature branch by @westey-m in #5310
- .NET: Hosting updates to declarative workflows by @alliscode in #5589
- docs: enhance README with 1.0 features and improved structure by @chetantoshniwal in #5534
- .NET: Update version for release by @westey-m in #5636
- .NET: Add Microsoft.Agents.AI.Hyperlight package for CodeAct integration (.NET) by @eavanvalkenburg in #5329
Full Changelog: dotnet-1.3.0...dotnet-1.4.0
python-1.2.2
[1.2.2] - 2026-04-29
Added
- agent-framework-azure-contentunderstanding: New alpha package — Azure AI Content Understanding context provider that auto-analyzes file attachments (documents, images, audio, video) and injects structured results into the LLM context, with multi-document session state, configurable timeout, output filtering via
AnalysisSection, and auto-registeredlist_documents/get_analyzed_documenttools (#4829) - agent-framework-foundry-hosting: Add hosted Durable Workflow support — propagate full conversation history to workflow agents and wire
Workflow.as_agent()end-to-end via the foundry hosting layer (#5531)
Changed
- agent-framework-orchestrations: [BREAKING] Standardize orchestration terminal outputs as
AgentResponsesoWorkflow.as_agent()returns the final answer only; aligns sequential-approval (with_request_info) and concurrent (intermediate_outputs=True) flows on the same output contract (#5301) - agent-framework-core, agent-framework-declarative: Preserve
Workflow.run()shared state across calls so multi-turnWorkflowAgentinvocations retain context, acceptlist[Message]input in the declarative start executor, and coerceEnumvalues when serializing PowerFx symbols (#5531) - dependencies: Update workspace package dependencies and preserve
mcp[ws]/uvicorn[standard]extras through override-dependencies in/python(#5555)
Fixed
- agent-framework-core: Fix observability spans not being correctly nested when using streaming (#5552)
- agent-framework-openai: Fix
file_searchcitations breaking the assistant-message history roundtrip — skiphosted_filecontent in the assistant role so the Responses API no longer rejectsinput_file(#5557)
Full Changelog: python-1.2.1...python-1.2.2
python-1.2.1
[1.2.1] - 2026-04-28
Added
- agent-framework-foundry-hosting: Add file data type support to hosted-agent Responses, refresh
foundry-hosted-agentssamples, and add response test coverage (#5485) - samples: Add
requirements.txtand.env.exampleto thea2a/hosting sample for pip-based setup (#5510)
Changed
- dependencies: Update
richrequirement from<15.0.0,>=13.7.1to>=13.7.1,<16.0.0in/python(#5227) - dependencies: Bump
prekfrom0.3.8to0.3.9in/python(#5228) - dependencies: Bump
python-multipartfrom0.0.22to0.0.26in/python(#5286) - dependencies: Bump
pyasn1from0.6.2to0.6.3in/python(#4748) - dependencies: Bump
pytestfrom9.0.2to9.0.3in/python/packages/ag-ui(#5461) - dependencies: Bump
pytestfrom9.0.2to9.0.3in/python/packages/devui(#5492) - dependencies: Bump
pytestfrom9.0.2to9.0.3in/python/packages/lab(#5470) - dependencies: Bump
uvfrom0.11.3to0.11.6in/python/packages/lab(#5469) - dependencies: Bump
vitefrom7.1.12to7.3.2in/python/packages/devui/frontend(#5127) - dependencies: Bump
vitefrom7.1.12to7.3.2in/python/samples/05-end-to-end/chatkit-integration/frontend(#5126) - dependencies: Bump
postcssfrom8.5.6to8.5.10in/python/packages/devui/frontend(#5484) - dependencies: Bump
postcssfrom8.5.6to8.5.10in/python/samples/05-end-to-end/chatkit-integration/frontend(#5491) - dependencies: Bump
postcssfrom8.5.6to8.5.12in/python/samples/05-end-to-end/ag_ui_workflow_handoff/frontend(#5527) - dependencies: Bump
picomatchfrom4.0.3to4.0.4in/python/packages/devui/frontend(#4921) - dependencies: Bump
picomatchfrom4.0.3to4.0.4in/python/samples/05-end-to-end/ag_ui_workflow_handoff/frontend(#4936)
Fixed
- agent-framework-core: Prevent
inner_exceptionfrom being lost inAgentFrameworkException(#5167)
Full Changelog: python-1.2.0...python-1.2.1
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.