agent-framework releases

What's Changed

• .NET: feat: Implement message filtering to exclude non-portable content typ… by @tarockey in https://github.com/microsoft/agent-framework/pull/5410
• .NET: Add allow listing for WebBrowsingTool by @westey-m in https://github.com/microsoft/agent-framework/pull/5605
• .NET: fix: JSON Serialization issue with MultiPartyConversation by @lokitoth in https://github.com/microsoft/agent-framework/pull/5653
• .NET: Improve Todo multithreading and inject todos into message list by @westey-m in https://github.com/microsoft/agent-framework/pull/5655
• .NET: fix: Add missing Workflows "Shared" sources to solution by @lokitoth in https://github.com/microsoft/agent-framework/pull/5656
• .NET: Fix QuestionExecutor looping after GotoAction re-entry in declarative workflows by @peibekwe in https://github.com/microsoft/agent-framework/pull/5635
• .NET: Fix YAML block scalar parsing for file skills by @tejakusireddy in https://github.com/microsoft/agent-framework/pull/5610
• .NET: Add hosted agent observability sample by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/5660
• .NET: Bump MEAI to 10.5.1 and add Foundry per-call x-client header support by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/5652
• .NET: Fix flaky declarative test by @peibekwe in https://github.com/microsoft/agent-framework/pull/5669
• .NET: Add Foundry.Hosting.IntegrationTests by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/5598
• .NET: Issue 5662 by @alliscode in https://github.com/microsoft/agent-framework/pull/5668
• .NET: Support reasoning events in AGUI by @jeffinsibycoremont in https://github.com/microsoft/agent-framework/pull/4953
• .NET: feat: Update Github Copilot SDK to 1.0.0-beta.2 by @lokitoth in https://github.com/microsoft/agent-framework/pull/5699
• .NET: feat: Implement Magentic Orchestration for .NET by @lokitoth in https://github.com/microsoft/agent-framework/pull/5595
• .NET: Foundry.Hosting IT - avoid MSB3026 in publish step by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/5689
• .NET: Python: Add dotnet integration test report to CI by @giles17 in https://github.com/microsoft/agent-framework/pull/5515
• .NET: Non-thread-safe sequence number generation may cause duplicate or out-of-order IDs by @tuanaiseo in https://github.com/microsoft/agent-framework/pull/5320
• .NET: Fix typo: sesionElement -> sessionElement by @XiongHaoTrigger in https://github.com/microsoft/agent-framework/pull/5674
• .NET: Mark Magentic Orchestration Experimental by @lokitoth in https://github.com/microsoft/agent-framework/pull/5704
• .NET: Fix function_call_output.output to be a JSON string on the wire by @alliscode in https://github.com/microsoft/agent-framework/pull/5705
• .NET: Update version for release by @lokitoth in https://github.com/microsoft/agent-framework/pull/5703

New Contributors

• @tarockey made their first contribution in https://github.com/microsoft/agent-framework/pull/5410
• @tejakusireddy made their first contribution in https://github.com/microsoft/agent-framework/pull/5610
• @jeffinsibycoremont made their first contribution in https://github.com/microsoft/agent-framework/pull/4953
• @tuanaiseo made their first contribution in https://github.com/microsoft/agent-framework/pull/5320
• @XiongHaoTrigger made their first contribution in https://github.com/microsoft/agent-framework/pull/5674

Full Changelog: https://github.com/microsoft/agent-framework/compare/dotnet-1.4.0...dotnet-1.5.0

[1.3.0] - 2026-05-07

Added

• agent-framework-core: Add ClassSkill for 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 AgentModeProvider mode changes (#5650)
• agent-framework-core: Information-flow control prompt injection defense (#5331)
• agent-framework-openai: Support OpenAI and Gemini allowed_tools tool choice (#5322)
• agent-framework-openai: Support GPT-5 verbosity option and restore Foundry agent_reference (#5619)
• agent-framework-anthropic: Add base_url parameter to AnthropicClient and RawAnthropicClient (#5685)
• agent-framework-foundry-hosting: Add support for function approval flow in Foundry hosted agent (#5666)
• agent-framework-declarative: Add Python parity for InvokeMcpTool in declarative workflow (#5630)
• agent-framework-declarative: Add Python parity for HttpRequestAction in declarative workflow (#5599)
• agent-framework-claude, agent-framework-github-copilot: Enforce approval_mode in Claude and GitHub Copilot agents (#5562)
• agent-framework-github-copilot: Upgrade github-copilot-sdk to v1.0.0b2 with instruction_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 MCPStreamableHTTPTool leaking asyncio.CancelledError when MCP server is unreachable (#5687)
• agent-framework-openai: Drop completed continuation_token from shared options in tool loop (#5462)
• agent-framework-bedrock: Don't send toolChoice when no tools are configured (#5172)
• agent-framework-hyperlight: Fix WasmSandbox cross-thread Drop and harden hosted-agent sample (#5603)
• agent-framework-devui: Fix incorrect workflow timings by adding created_at to executor events (#5615)
• agent-framework-foundry-hosting: Fix hosted MCP replay producing orphan function_call_output (#5581)

What's Changed

• .NET: Bump OpenTelemetry packages to 1.15.3 by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/5478
• .NET: Support returning durable workflow results from HTTP trigger endpoint by @kshyju in https://github.com/microsoft/agent-framework/pull/5321
• .NET: [Breaking] Support string[] arguments for file-based skill scripts by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/5475
• .NET: Add HttpRequestAction support to declarative workflows by @peibekwe in https://github.com/microsoft/agent-framework/pull/5474
• .NET: Add declarative HttpRequestAction sample by @peibekwe in https://github.com/microsoft/agent-framework/pull/5572
• .NET: dotnet: Add hosted-agent User-Agent supplement to outgoing requests by @alliscode in https://github.com/microsoft/agent-framework/pull/5453
• .NET: Add dedicated Foundry.Hosting UnitTest project by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/5592
• .NET: Harness Feature branch by @westey-m in https://github.com/microsoft/agent-framework/pull/5310
• .NET: Hosting updates to declarative workflows by @alliscode in https://github.com/microsoft/agent-framework/pull/5589
• docs: enhance README with 1.0 features and improved structure by @chetantoshniwal in https://github.com/microsoft/agent-framework/pull/5534
• .NET: Update version for release by @westey-m in https://github.com/microsoft/agent-framework/pull/5636
• .NET: Add Microsoft.Agents.AI.Hyperlight package for CodeAct integration (.NET) by @eavanvalkenburg in https://github.com/microsoft/agent-framework/pull/5329

Full Changelog: https://github.com/microsoft/agent-framework/compare/dotnet-1.3.0...dotnet-1.4.0

[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-registered list_documents / get_analyzed_document tools (#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 AgentResponse so Workflow.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-turn WorkflowAgent invocations retain context, accept list[Message] input in the declarative start executor, and coerce Enum values 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_search citations breaking the assistant-message history roundtrip — skip hosted_file content in the assistant role so the Responses API no longer rejects input_file (#5557)

Full Changelog: https://github.com/microsoft/agent-framework/compare/python-1.2.1...python-1.2.2

[1.2.1] - 2026-04-28

Added

• agent-framework-foundry-hosting: Add file data type support to hosted-agent Responses, refresh foundry-hosted-agents samples, and add response test coverage (#5485)
• samples: Add requirements.txt and .env.example to the a2a/ hosting sample for pip-based setup (#5510)

Changed

• dependencies: Update rich requirement from <15.0.0,>=13.7.1 to >=13.7.1,<16.0.0 in /python (#5227)
• dependencies: Bump prek from 0.3.8 to 0.3.9 in /python (#5228)
• dependencies: Bump python-multipart from 0.0.22 to 0.0.26 in /python (#5286)
• dependencies: Bump pyasn1 from 0.6.2 to 0.6.3 in /python (#4748)
• dependencies: Bump pytest from 9.0.2 to 9.0.3 in /python/packages/ag-ui (#5461)
• dependencies: Bump pytest from 9.0.2 to 9.0.3 in /python/packages/devui (#5492)
• dependencies: Bump pytest from 9.0.2 to 9.0.3 in /python/packages/lab (#5470)
• dependencies: Bump uv from 0.11.3 to 0.11.6 in /python/packages/lab (#5469)
• dependencies: Bump vite from 7.1.12 to 7.3.2 in /python/packages/devui/frontend (#5127)
• dependencies: Bump vite from 7.1.12 to 7.3.2 in /python/samples/05-end-to-end/chatkit-integration/frontend (#5126)
• dependencies: Bump postcss from 8.5.6 to 8.5.10 in /python/packages/devui/frontend (#5484)
• dependencies: Bump postcss from 8.5.6 to 8.5.10 in /python/samples/05-end-to-end/chatkit-integration/frontend (#5491)
• dependencies: Bump postcss from 8.5.6 to 8.5.12 in /python/samples/05-end-to-end/ag_ui_workflow_handoff/frontend (#5527)
• dependencies: Bump picomatch from 4.0.3 to 4.0.4 in /python/packages/devui/frontend (#4921)
• dependencies: Bump picomatch from 4.0.3 to 4.0.4 in /python/samples/05-end-to-end/ag_ui_workflow_handoff/frontend (#4936)

Fixed

• agent-framework-core: Prevent inner_exception from being lost in AgentFrameworkException (#5167)

Full Changelog: https://github.com/microsoft/agent-framework/compare/python-1.2.0...python-1.2.1

[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_request events from Responses API in Foundry clients (#5070)

Changed

• agent-framework-core, agent-framework-foundry: Update FoundryAgent for 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 every FoundryChatClient call (#5440)
• agent-framework-anthropic, agent-framework-azure-ai-search, agent-framework-azure-cosmos: Fix user agent prefix (#5455)

Full Changelog: https://github.com/microsoft/agent-framework/compare/python-1.1.1...python-1.2.0

What's Changed

• .NET: Add dynamic tool expansion sample by @westey-m in https://github.com/microsoft/agent-framework/pull/5425
• .NET: Update Aspire package to be preview by @westey-m in https://github.com/microsoft/agent-framework/pull/5444
• .NET: Fix off-thread RunStatus race where GetStatusAsync can return Running after ResumeAsync halts by @peibekwe in https://github.com/microsoft/agent-framework/pull/5412
• .NET: Update versions for release by @westey-m in https://github.com/microsoft/agent-framework/pull/5449
• .NET: Add streaming support to A2A agent handler by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/5427
• .NET: dotnet: Add server-side Foundry Toolbox support and fix SDK beta.4 br… by @alliscode in https://github.com/microsoft/agent-framework/pull/5450

Full Changelog: https://github.com/microsoft/agent-framework/compare/dotnet-1.2.0...dotnet-1.3.0

[1.1.1] - 2026-04-23

Added

• agent-framework-core: Add expected_output ground-truth support to evaluate_workflow for similarity evaluators (#5234)
• agent-framework-ag-ui, agent-framework-a2a: Propagate thread_id and forwarded_props through AG-UI to A2A context_id (#5383)
• samples: Add second approval-required tool (set_stop_loss) to concurrent_builder_tool_approval sample (#4875)
• agent-framework-core: Add SKIP_PARSING sentinel for FunctionTool.invoke to bypass Content-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, switch execute_code input schema to a plain JSON-schema dict, and tighten public API
  surface (#5424)

Fixed

• agent-framework-openai: Fix OpenAI Responses streaming to propagate created_at from the final response.completed event (#5382)
• agent-framework-openai: Fix OpenAIEmbeddingClient to use AsyncOpenAI for /openai/v1 endpoints (#5137)
• agent-framework-openai: Exclude null file_id from input_image payload 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_id as session_id when constructing AgentSession (#5384)
• agent-framework-hyperlight: Thread-confine WasmSandbox interactions via per-entry ThreadPoolExecutor to eliminate the PyO3 unsendable panic when touched from asyncio worker threads
  (#5424)

Full Changelog: https://github.com/microsoft/agent-framework/compare/python-1.1.0...python-1.1.1

Changes:

• f2b215a2f6d4767fd37b17dd33195100ea2e498f .NET [WIP] Foundry Hosted Agents Support (#5312) [ #5091, #5287, #5278, #5281, #5316, #5336, #5341, #5367, #5368, #5371, #5374, #5406, #5408 ]
• 57fa8ea9022ac9ec39fb5ececb020aa042599c8f Python: Fix OpenAIEmbeddingClient to use AsyncOpenAI for /openai/v1 endpoints (#5137) [ #5068 ]
• aa582d021d69dd3b047d7664ced090dcc08b56f2 Python: feat(evals): add ground_truth support for similarity evaluator (#5234)
• 8f17067383154e87e3a3c8ae673c7b5f1cf71add .NET: Update .NET package version 1.2.0 (#5364)
• 267351b7607595cfcb2d64c739587bc50a476e2f .NET: Expand Workflow Unit Test Coverage (#5390)
• adcd2d33f5e32be85ea141fc8cc6fbe590aa0981 .NET: Declarative workflows - Gracefully handle agent scenarios when no response is returned (#5376)
• d5777bc546ba48652d85cec6093b445965533a4a fix: Duplicate CallIds cause Handoff Message Filtering to fail (#5359)
• b6b191ad9c2ddaaa8a647419135f01a2d3fce73a Python: Add second approval-required tool (set_stop_loss) to concurrent_builder_tool_approval sample (#4875) [ #4874 ]
• 2c8036779c20e5fa2feb6304c01e28c594e801a9 Python: Bump versions for a release. Update CHANGELOG (#5385)
• ce8b6305d8e7280ac9d22226a17e2e4f0828ef97 Python: Foundry hosted agent V2 (#5379) [ #5177, #5215, #5235, #5261, #5281, #5284, #5298, #5372, #5378 ]

• 07f4c8a8d66d2fba40bdd086f16cc6dca059d054 Python: Expose forwardedProps to agents and tools via session metadata (#5264) [ #5239 ]
• 04aaf0c1fe6023a579a334f9d2afe5b79ca497f0 Python: Add support for Foundry Toolboxes (#5346)
• 3e54a689fc96d681a072fe7e7cfc445909dac74b Python: Add search tool content for OpenAI responses (#5302)
• 60af59ba8b3c871065d0a288f21bfd7f0d6be3c1 .NET: Features/3768-devui-aspire-integration (#3771)
• 69894eded89d6e8ebf7bdb75cd0d9da54ade8b21 Python: Flatten hyperlight execute_code output (#5333)
• 495e1dad6bf3c62b14929805cfd5f0409c897876 Python: Fix CopilotStudioAgent to reuse conversation ID from existing session (#5299) [ #5285 ]
• 5777ed26e62e721375f78c404b8df1dfbc322560 .NET: fix: Add session support for Handoff-hosted Agents (#5280)
• 52303a8d07e8f9f2c3f056d969d99a9062c06219 .NET: Add Code Interpreter container file download samples (#5014) [ #3081 ]
• c85d24da440ebe5266852f6356aecdadc41379c6 .NET: Fix declarative resume edge predicates to recognize both direct and PortableValue-wrapped forms after checkpoint restore (#5323)
• b03cb324d5cc5e91a55b5eb9045b8ead244aaf11 Python: Add Hyperlight CodeAct package and docs (#5185)
• dbf935b4e30cf9ae2553cad54f6bc09668f7eb62 .NET: fix: Foundry Agents without description in Handoff (#5311)
• ca580a8316a904e947e48aaba8f3c00eb738ae36 .NET: Add error checking to workflow samples (#5175)
• 101e07b0610e2a73e0c369be7e81907a44fb243f .NET: Add Handoff sample (#5245)
• aee1acbf8baeb9fb3b3f196975aae9e7f7481096 .NET: Foundry Evals integration for .NET (#4914) [ #5269 ]
• 91e34358eb4f2643b13537b470d8ea0aeaec7307 Python: Feat: Add finish_reason support to AgentResponse and AgentResponseUpdate (#5211) [ #4622 ]
• 90a633967ca60601fc696d335d770f9f05e236e2 Python: Fix Gemini client support for Gemini API and Vertex AI (#5258)
• c14beedb3af8bdee168e3a06a245a5b9d8fa5f75 test: Add Handoff composability test (#5208)
• 43d98974d3994486a35602467efcffb85839ce66 fix: propagate A2A metadata with namespaced key in additional_properties (#5240) (#5256)
• 60da0ffb4803e0db18d3d3bde8e008eb4277882c .NET: Improve local release build perf by only formatting for one build target framework (#5266)
• a2044829b13659ac40f7f4112f74efcce15397cc .NET: Update Microsoft.Extensions.AI to 10.5.0 and OpenAI to 2.10.0 and remove unused refs (#5269)
• 435c66e9c9f215fdea4b041da35e6ca774b63094 Python: Handle url_citation annotations in FoundryChatClient streaming responses (#5071) [ #5029 ]
• 52d50be9e06456aa8dc4adb2525b0bbd4f60d4d3 Bump Anthropic SDK to 12.13.0 and Anthropic.Foundry to 0.5.0 (#5279)
• d20f9b5f973b0b8f693f530a8e3c0f9d9c99bb94 Add AgentExecutorResponse.with_text() to preserve conversation history through custom executors (#5255) [ #5246 ]
• 87a8fa2a9d0ffd3d0b4b31882e70c4f60462bb29 .NET: Fix intermittent checkpoint-restore race in in-process workflow runs (#5134)
• 8f7fd9525d1bf24f9606779ba7f8d41b66ce2ff1 Python: Add OpenAI types to default checkpoint encoding allow list (#5297)
• 69697065ab78502c5e58a7e6bc90ae14fdc46c20 Python: Add context_providers and description to workflow.as_agent() (#4651)
• fe4cd3cddc99f157710296dad892bec427cae991 Revert to public MCP server and skip on transient upstream errors (#5296)
• 611230cc8ebde031d6c15dbc15d7053ddf56b40c Python: improve misc-integration test robustness (#5295)
• f112150cfbc4d514b21b60a81bbe5239b4b2c81f Python: bump misc-integration retry delay to 30s (#5293)
• ff05c22c5853a51b83c05b6fdb3b8e982bbf3b31 Python: add experimental file history provider (#5248)
• eab7f09d03387a2b393f9785963353c1a09e8b6b Forward provider config to SessionConfig in GitHubCopilotAgent (fixes #5190) (#5195)
• 68b93641b6802abd2d00a5191cb16c6074d39fe1 Python: Bump agent-framework-devui to 1.0.0b260414 for release (#5259)
• 2b251d904f1cb045ec3b7e13411cac3c1aa1e019 Python: Fix reasoning replay when store=False (#5250)
• 485af07b8c21896b7f24a0313b5a226b3bd711f8 Python: Add GeminiChatClient (#4847)
• 64c68ca8576ccfde295d0cf1db51bd5c2b9bed82 Python: Skip get_final_response in OTel _finalize_stream when stream errored (#5232) [ #5231 ]
• 98e17764a47141739d1a1b24eae9f3c6649f9626 Python: Fix DevUI streaming memory growth and add cross-platform regression coverage (#5221)
• 7bb0feca591d63722d520dbc94af76d70b206129 Python: Move InMemory history provider injection to the first invocation (#5236)
• f183f888a344031e348f966110498eeb468fe0eb Python: AG-UI deterministic state updates from tool results (#5201)
• 3c31ac28b53562b1db91f2c42a86d083b8d7dd14 Python: Fix HandoffBuilder dropping function-level middleware when cloning agents (#5220) [ #5173 ]
• 1b95e8585d7e892c42c62313908664b8d7c7e1a8 Python: Add allowed_checkpoint_types support to CosmosCheckpointStorage for parity with FileCheckpointStorage (#5202) [ #5200, #3 ]
• b89adb280b45a41ab0f0ff28d7947a73d3adbd4c Python: skill name validation improvements (#4530)
• 913397492fd9a4d42c46d7d874c409549686827d Bump pygments from 2.19.2 to 2.20.0 in /python (#4978)
• 952e685e176d9499aff484224e7133885f16d4cf Python: Fix python-feature-lifecycle skill YAML frontmatter (#5226)
• b1fb63eb81785e1f5d72d0738df868fb250077a9 .NET: Update AGUI service to support session storage (#5193)
• 76fe7319e066b56bf3818c67e2ddadf7ccefe3cf .NET: feat: Refactor Handoff Orchestration and add HITL support (#5174)
• 39b560f83cf6effcdbff0b69e96f830f06ab1432 Add missing path to verify-samples run checkout (#5194)

This list of changes was auto generated.

[1.1.0] - 2026-04-21

Added

• agent-framework-gemini: Add GeminiChatClient (#4847)
• agent-framework-core: Add context_providers and description to workflow.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_reason support to AgentResponse and AgentResponseUpdate (#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 forwardedProps to agents and tools via session metadata (#5264)
• agent-framework-foundry: Add hosted agent V2 support (#5379)

Changed

• agent-framework-azure-cosmos: [BREAKING] CosmosCheckpointStorage now uses restricted pickle deserialization by default, matching FileCheckpointStorage behavior. If your checkpoints contain application-defined types, pass them via allowed_checkpoint_types=["my_app.models:MyState"]. (#5200)
• agent-framework-core: Improve skill name validation (#4530)
• agent-framework-azure-cosmos: Add allowed_checkpoint_types support to CosmosCheckpointStorage for parity with FileCheckpointStorage (#5202)
• agent-framework-core: Move InMemory history provider injection to first invocation (#5236)
• agent-framework-github-copilot: Forward provider config to SessionConfig in GitHubCopilotAgent (#5195)
• agent-framework-hyperlight-codeact: Flatten execute_code output (#5333)
• dependencies: Bump pygments from 2.19.2 to 2.20.0 in /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-lifecycle skill YAML frontmatter (#5226)
• agent-framework-core: Fix HandoffBuilder dropping 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_response in _finalize_stream when the stream has errored (#5232)
• agent-framework-openai: Fix reasoning replay when store=False (#5250)
• agent-framework-foundry: Handle url_citation annotations in FoundryChatClient streaming responses (#5071)
• agent-framework-gemini: Fix Gemini client support for Gemini API and Vertex AI (#5258)
• agent-framework-copilotstudio: Fix CopilotStudioAgent to reuse conversation ID from an existing session (#5299)

Full Changelog: https://github.com/microsoft/agent-framework/compare/python-1.0.1...python-1.1.0

Changes:

• ecc34ff902289ac30f6b6d4c926ccd2081e8a28d Net: Publish all packages as 0.0.1-preview.260417.2 (#5341) [ #5336 ]
• 31acaccc500239367916a0800c8cda32f34edb22 Net: Prepare Foundry Preview Release (#5336)
• e737ac6a449ac4c38e72a6c0f41acd70677513b1 .NET: Auto-instrument resolved AIAgents with OpenTelemetry for Foundry Hosted Agents (#5316)
• 8f5a6ec4a1896e5432eb800bafdf4ad53d2b6c20 Fix AgentFrameworkResponseHandlerTests: implement session methods in test mock agents
• 518e90e1140852eb70b635736b5c029b5eb21fe7 Add Dockerfiles, README, agent yamls and bearer token support to Hosted-Workflow-Handoff
• 7c9ed7f5d67488b60e62777e36479289833746fa Remove FoundryResponsesRepl and empty FoundryResponsesHosting directory
• 77529dc3ea6e7359a2ddbbbddde56d6530e175ea Rename Hosted-Workflows to Hosted-Workflow-Simple, Hosted-WorkflowHandoff to Hosted-Workflow-Handoff
• e6dfdd46f207d86ea79c1e160934b2e6e5d7deba Move FoundryResponsesHosting to responses/Hosted-WorkflowHandoff, use GetResponsesClient
• 10077bdb130b7293037de8ed4840b92aea59a811 Use placeholder for AGENT_NAME in Hosted-FoundryAgent .env.example
• 98d3a81ed4a59bc5a8f370732f3b5fead2646fd0 Remove launchSettings, use .env for port configuration

• d49d546bb4286fd1a322fabb62855310c57d90e1 Restructure FoundryHostedAgents samples into invocations/ and responses/ [ #5281 ]
• 030ef3a115c68927673613ca1756861a50d6d1c7 Merge branch 'feature/responses-hosting' of https://github.com/microsoft/agent-framework into hosted-agent-adapter
• 53fec2a989d669adfc954cba195ac12ee6dbac50 Add Invocations protocol samples (hosted echo agent + client) (#5278)
• 93306f5f5bc8ad17720d21b840746293890434f5 Register AgentSessionStore in test DI setups
• bc303d87f4e86093791865ec28380d28ca055186 Fix dotnet format: add Async suffix to test methods (IDE1006), fix encoding and style
• 8d30cadc837cf7a42eafd1eb6367d966c07f7db6 Fix CHARSET: add UTF-8 BOM to Hosted-LocalTools and Hosted-Workflows
• c1ea834e1fd05038f93ea126417d0776460610b5 Fix IDE0009: add 'this' qualification in all HostedAgentsV2 samples
• e751779da464e2f9a9c5e86ab4da13d7282bb342 Fix IDE0009: add 'this' qualification in DevTemporaryTokenCredential
• 5af3d470621c18a954513a6c6041e6fed037c7f7 Fixing small issues.
• 4739d1ec9cce1979e6d831db76e899f23c7c6f80 Bump Azure.AI.AgentServer packages to 1.0.0-beta.1/beta.21 and fix breaking API changes
• 930d47789a1399355e001fafada3adb9c1ab3766 Add Hosted-McpTools sample with dual MCP pattern
• 8b49a0a2077b6cac171c826fe9f386df34964c08 Removing extra using samples
• e70f20622a50f91e72383d47443a2bc4785064ee Adding LocalTools + Workflow samples
• 0949260d16852e56b8e8395557f802f7c9b1ef72 Version bump
• 28f3d178e1aff10e49fd52e8743d976b2be47e07 Address text rag sample working
• ebb3483a2c0a9358a755bfa1f6da771b2b137fcc Foundry Agent Hosting
• 9e820aaad778af199bac935e25cf1d54b98c0026 Update chat client agent for contributor and devs
• a4519045a49d8e4fae1f0cfdf7ae57a864744024 Using updates
• ac6a0e3d956c1d220dcd880123afb2792140c943 Adding SessionStorage and SessionManagement, improving samples to align Consumption vs Hosting
• 990330e1985afa5013847d781e96968830bc3691 ChatClientAgent working
• 3ef5436537f34b5e40c79182f9e7ef80d89fe1bc Hosting Samples update
• 3984ef4ef14ca086c1f4d8044d26bb775674cfea Hosting Samples update
• bf779f20292cf29dc91df3514cab7997d60ac2af Hosting Samples update
• d0fc7499b753666bafb40208b1d59d6331f7f300 Hosting Samples update
• 3a2617997e11f1e2b877db6fc1ec357ee8d4c139 Add UserAgent middleware tests for Foundry hosting
• cf4a3f691442f062a2aa2462b97caf4f7375b61f Bump hosted internal package version
• 34eeea165d4750e90223d496c99f49b995f4465f Address breaking changes in 260408
• 6e834fcac2100c3401fa7389646935e03b2c971f Renaming and merging hosting extensions. (#5091)
• a25502b7c8f53f91b74417c97aaf2d72a73dc966 Catch agent errors and emit response.failed with real error message
• afce5665e29c74bea29b40353ea94f4b01d0e24c Fix model override bug and add client REPL sample
• eccdcffc6cc60cfc912962d3f23fb5c5dc5ae98e Fix CA1873: guard LogWarning with IsEnabled check
• 226abebac287517fe5f75777d020669e98c81cec Bump OpenTelemetry packages to fix NU1109 downgrade errors
• 4a2e25573f5d020caad04b1cd0552c049a407f8b Bump package version to 0.9.0-hosted.260402.2
• 838fd7f4d0e6513490f8d222056ae3e88a571df5 Move Foundry Responses hosting into Microsoft.Agents.AI.Foundry package
• 4dd3a3087505cd742678738581fd6bf5b61a4c03 Add hosted package version suffix (0.9.0-hosted) to distinguish from mainline
• 5368e530a8cb781a170e4388b8121afccd158b54 Update Azure.AI.AgentServer packages to 1.0.0-alpha.20260401.5
• 15e36efe39686813f59708ada45c4200c0d3f4c9 Clean up tests and sample formatting
• e5c1203f4dc234281d7d1183b518ce39e5d85b6e Bump System.ClientModel to 1.10.0 for Azure.Core 1.52.0 compat
• 12251b1e69abce25b68d1f25d2b93e425d78dea8 Add Azure AI Foundry Responses hosting adapter
• 548dfb10b69ae3938e0c1944f09051dfa3b134a2 .NET: Bump Azure.AI.AgentServer packages to 1.0.0-beta.1/beta.21 and fix br… (#5287)
• ff05c22c5853a51b83c05b6fdb3b8e982bbf3b31 Python: add experimental file history provider (#5248)
• eab7f09d03387a2b393f9785963353c1a09e8b6b Forward provider config to SessionConfig in GitHubCopilotAgent (fixes #5190) (#5195)
• 68b93641b6802abd2d00a5191cb16c6074d39fe1 Python: Bump agent-framework-devui to 1.0.0b260414 for release (#5259)
• 2b251d904f1cb045ec3b7e13411cac3c1aa1e019 Python: Fix reasoning replay when store=False (#5250)
• 5b16684930f6ac484b8b1e7741a1ae2f91247b48 Add Hosted-McpTools sample with dual MCP pattern
• 485af07b8c21896b7f24a0313b5a226b3bd711f8 Python: Add GeminiChatClient (#4847)
• 64c68ca8576ccfde295d0cf1db51bd5c2b9bed82 Python: Skip get_final_response in OTel _finalize_stream when stream errored (#5232) [ #5231 ]
• 98e17764a47141739d1a1b24eae9f3c6649f9626 Python: Fix DevUI streaming memory growth and add cross-platform regression coverage (#5221)
• 7bb0feca591d63722d520dbc94af76d70b206129 Python: Move InMemory history provider injection to the first invocation (#5236)
• f183f888a344031e348f966110498eeb468fe0eb Python: AG-UI deterministic state updates from tool results (#5201)
• 3c31ac28b53562b1db91f2c42a86d083b8d7dd14 Python: Fix HandoffBuilder dropping function-level middleware when cloning agents (#5220) [ #5173 ]
• 1b95e8585d7e892c42c62313908664b8d7c7e1a8 Python: Add allowed_checkpoint_types support to CosmosCheckpointStorage for parity with FileCheckpointStorage (#5202) [ #5200, #3 ]
• b89adb280b45a41ab0f0ff28d7947a73d3adbd4c Python: skill name validation improvements (#4530)
• 913397492fd9a4d42c46d7d874c409549686827d Bump pygments from 2.19.2 to 2.20.0 in /python (#4978)
• 952e685e176d9499aff484224e7133885f16d4cf Python: Fix python-feature-lifecycle skill YAML frontmatter (#5226)
• 1584879edd63814cfe95d836ac37727cd1e72893 Removing extra using samples
• b1fb63eb81785e1f5d72d0738df868fb250077a9 .NET: Update AGUI service to support session storage (#5193)
• 4b9d848541ec462a0a8cb4b14ff4eeb696e79aed Adding LocalTools + Workflow samples
• d02cee5353c1b02f0bc118e5b99654c968647017 Version bump
• ad625602a3b0afa65d7c0ce0fb3fb022426be05d Address text rag sample working
• 76fe7319e066b56bf3818c67e2ddadf7ccefe3cf .NET: feat: Refactor Handoff Orchestration and add HITL support (#5174)
• 340ec82623ffbe047e063c768aab933f19d17586 Foundry Agent Hosting
• 9e842e18214c4d5dfa03bfdfbac2e12316f9bb8f Update chat client agent for contributor and devs
• 39b560f83cf6effcdbff0b69e96f830f06ab1432 Add missing path to verify-samples run checkout (#5194)
• 4895ad74e13bf22fdb1ed4c36090bb81787ff0a2 Using updates
• fcc96823a48521f8026a5d9735f172c080c05097 Adding SessionStorage and SessionManagement, improving samples to align Consumption vs Hosting
• a82c1ede09e84dc3f4c80d342cbc58b8d0e030ed ChatClientAgent working
• eb7f8617c1f7bf6b36b004fa209abc11f70b64ab Hosting Samples update
• 026f71ac32f3790b421d9c8ca3f32421512c1d66 Hosting Samples update
• 4ab43734c65d355efdb3deb203fcacb9141ffc55 Hosting Samples update
• 7407c0a35ed2e4cb69fdcf9bbe0db5dfb07d7bdc Hosting Samples update
• fed3c06817e89b6dc348541dc3dff9a982b6e86f Add UserAgent middleware tests for Foundry hosting
• 176b8f9b3419b08ffd163b190633701541d5c6a0 Bump hosted internal package version
• 53dd99018599fb0e93e1ccc65cf4d9790d1307b3 Address breaking changes in 260408
• 23db9569ce9e4d4faceaec85fece61f4cfcae3ef Renaming and merging hosting extensions. (#5091)
• eb673790338d3c977e1744e88280e8289cbb6bf7 Catch agent errors and emit response.failed with real error message
• 21dc5311bea7f8238db6890449e73d8dbdd68e8f Fix model override bug and add client REPL sample
• 3b03c6dd5579ebf55a2a8afefc5ba381efd60e7d Fix CA1873: guard LogWarning with IsEnabled check
• 5ba8521ce265f60b17ebc131e31b93377928ee40 Bump OpenTelemetry packages to fix NU1109 downgrade errors
• af9807b4a4540867646df3f4512fab545b50c068 Bump package version to 0.9.0-hosted.260402.2
• a1c19b90cd0bbc6f3cd9d51dcf59a77e3b9837d3 Move Foundry Responses hosting into Microsoft.Agents.AI.Foundry package
• bb7082d3c6cad737ffc390ce4995eb94d472f451 Add hosted package version suffix (0.9.0-hosted) to distinguish from mainline
• 59ad42912ff3992947adab61453d29e187830bf2 Update Azure.AI.AgentServer packages to 1.0.0-alpha.20260401.5
• 52cc4a9f0e9c1666420ebcc3baf7486fb83b366c Clean up tests and sample formatting
• 69597d7d77c549dde20a78c5a873cac2e4cdcb42 Bump System.ClientModel to 1.10.0 for Azure.Core 1.52.0 compat
• 0b1ed03cd00c997cd668bb19a68776a5616a0fd2 Add Azure AI Foundry Responses hosting adapter

This list of changes was auto generated.

What's Changed

• .NET: Add Foundry Memory Context Provider by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/3522
• .NET: Replace inline string literals with constants in ChatHistoryMemoryProvider by @westey-m in https://github.com/microsoft/agent-framework/pull/4096
• .NET: Fix failing vision integration tests by using local test files by @Copilot in https://github.com/microsoft/agent-framework/pull/4128
• .NET: Support Agent Skills by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/4122
• Added new GitHub action for manual integration test run based on PR by @dmytrostruk in https://github.com/microsoft/agent-framework/pull/4135
• .NET: Simplify store=false scenario for responses by @westey-m in https://github.com/microsoft/agent-framework/pull/4124
• .NET: Add Foundry Agents Tool Sample - Memory Search by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/3700
• .NET: [BREAKING] Add ChatClient decorator for calling AIContextProviders by @westey-m in https://github.com/microsoft/agent-framework/pull/4097
• Updated GitHub action for manual integration tests by @dmytrostruk in https://github.com/microsoft/agent-framework/pull/4147
• .NET: Fix Structured Output for agents configured with function middleware by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/4179
• Make Cosmos DB tests read COSMOSDB_ENDPOINT and COSMOSDB_KEY from environment variables by @Copilot in https://github.com/microsoft/agent-framework/pull/4156
• .NET: Add Foundry Agents Tool Sample - Web Search by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/4040
• .NET: Fix case-sensitive property mismatch in CosmosChatHistoryProvider queries by @Copilot in https://github.com/microsoft/agent-framework/pull/3485
• Revert devcontainer bug workaround by @westey-m in https://github.com/microsoft/agent-framework/pull/4206
• .NET: Add Foundry Agents Tool Sample - Bing Custom Search by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/3701
• .NET: Fix JSON arrays of objects parsed as empty records when no schema is defined by @LEDazzio01 in https://github.com/microsoft/agent-framework/pull/4199
• .NET: Implement Task support for A2A Hosting package by @DeagleGross in https://github.com/microsoft/agent-framework/pull/3732
• Add Additional Properties ADR by @westey-m in https://github.com/microsoft/agent-framework/pull/4246
• .NET: Add Foundry SharePoint Tool Sample by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/4227
• .NET: Update .NET package version to rc2 by @dmytrostruk in https://github.com/microsoft/agent-framework/pull/4257

Full Changelog: https://github.com/microsoft/agent-framework/compare/dotnet-1.0.0-rc1...dotnet-1.0.0-rc2

What's Changed

• .NET: Add tests for subworkflow shared state behavior by @lokitoth in https://github.com/microsoft/agent-framework/pull/3444
• .NET: Improve unit test coverage for Microsoft.Agents.AI.AzureAI to 85.6% by @Copilot in https://github.com/microsoft/agent-framework/pull/3383
• .Net: Adding copilot cli to the codespaces definition by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/3479
• .NET: Python: [BREAKING] Renamed Github to GitHub by @dmytrostruk in https://github.com/microsoft/agent-framework/pull/3486
• .NET - [Breaking]: Update Declarative Object Model + Dependencies by @crickman in https://github.com/microsoft/agent-framework/pull/3017

Full Changelog: https://github.com/microsoft/agent-framework/compare/dotnet-1.0.0-preview.260127.1...dotnet-1.0.0-preview.260128.1

What's Changed

• .NET: Adding feature collections ADR by @westey-m in https://github.com/microsoft/agent-framework/pull/3332
• .NET: [Breaking] Allow passing auth token credential to cosmosdb extensions by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/3250
• .NET: [BREAKING] fix: Subworkflows do not work well with Chat Protocol and Checkpointing by @lokitoth in https://github.com/microsoft/agent-framework/pull/3240
• .NET: Joslat fix sample issue by @joslat in https://github.com/microsoft/agent-framework/pull/3270
• .NET: Improve unit test coverage for Microsoft.Agents.AI.OpenAI by @Copilot in https://github.com/microsoft/agent-framework/pull/3349
• .NET: Expose Executor Binding Metadata from Workflows by @kshyju in https://github.com/microsoft/agent-framework/pull/3389
• .NET: Allow overriding the ChatMessageStore to be used per agent run. by @westey-m in https://github.com/microsoft/agent-framework/pull/3330
• Update instructions to require automatically building and formatting by @westey-m in https://github.com/microsoft/agent-framework/pull/3412
• .NET: [BREAKING] Rename ChatMessageStore to ChatHistoryProvider by @westey-m in https://github.com/microsoft/agent-framework/pull/3375
• .NET: [BREAKING] feat: Improve Agent hosting inside Workflows by @lokitoth in https://github.com/microsoft/agent-framework/pull/3142
• .NET: Improve unit test coverage for Microsoft.Agents.AI.AzureAI.Persistent by @Copilot in https://github.com/microsoft/agent-framework/pull/3384
• .NET: Improve unit test coverage for Microsoft.Agents.AI.Anthropic by @Copilot in https://github.com/microsoft/agent-framework/pull/3382
• Workaround for devcontainer expired key issue by @westey-m in https://github.com/microsoft/agent-framework/pull/3432
• .NET: [BREAKING] Rename AgentThread to AgentSession by @westey-m in https://github.com/microsoft/agent-framework/pull/3430
• .NET: ci: Unblock Merge queue by disabling DurableTask TTL tests by @lokitoth in https://github.com/microsoft/agent-framework/pull/3464
• .NET: Updated package versions by @dmytrostruk in https://github.com/microsoft/agent-framework/pull/3459
• .NET: Add AIAgent implementation for GitHub Copilot SDK by @Copilot in https://github.com/microsoft/agent-framework/pull/3395
• .NET: Expose metadata from A2AAgent and seal AIAgentMetadata by @westey-m in https://github.com/microsoft/agent-framework/pull/3417
• .NET: fix: FileSystemJsonCheckpointStore does not flush to disk on Checkpoint creation by @lokitoth in https://github.com/microsoft/agent-framework/pull/3439
• .NET: Added GitHub Copilot project to release solution file by @dmytrostruk in https://github.com/microsoft/agent-framework/pull/3468
• Add C# GroupChat tool approval sample for multi-agent orchestrations by @Copilot in https://github.com/microsoft/agent-framework/pull/3374

[1.0.0b260127] - 2026-01-27

Added

• agent-framework-github-copilot: Add BaseAgent implementation for GitHub Copilot SDK (#3404)

What's Changed

• .NET: [Durable Agents] Reliable streaming sample by @cgillum in https://github.com/microsoft/agent-framework/pull/2942
• .NET: [Breaking] Introduce RunCoreAsync/RunCoreStreamingAsync delegation pattern in AIAgent by @Copilot in https://github.com/microsoft/agent-framework/pull/2749
• .NET: [BREAKING] Refactor ChatMessageStore methods to be similar to AIContextProvider and add filtering support by @westey-m in https://github.com/microsoft/agent-framework/pull/2604
• [BREAKING] Remove unused AgentThreadMetadata by @westey-m in https://github.com/microsoft/agent-framework/pull/3067
• .NET: Seal ChatClientAgentThread by @Copilot in https://github.com/microsoft/agent-framework/pull/2842
• .NET: Fix message ordering inconsistency when using AIContextProvider by @Copilot in https://github.com/microsoft/agent-framework/pull/2659
• .NET: Seal factory contexts and add non JSO deserialize overloads by @westey-m in https://github.com/microsoft/agent-framework/pull/3066
• updated templates by @eavanvalkenburg in https://github.com/microsoft/agent-framework/pull/3106
• .NET: Make A2AAgent public, so that its concrete implementation methods can be used. by @westey-m in https://github.com/microsoft/agent-framework/pull/3119
• .NET: Map additional props <-> A2A metadata by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/3137
• .NET: Bump AWSSDK.Extensions.Bedrock.MEAI from 4.0.5 to 4.0.5.1 by @dependabot[bot] in https://github.com/microsoft/agent-framework/pull/2994
• .NET: Bump Anthropic from 12.0.0 to 12.0.1 by @dependabot[bot] in https://github.com/microsoft/agent-framework/pull/2993
• .NET: fix: Expose WorkflowErrorEvent as ErrorContent by @lokitoth in https://github.com/microsoft/agent-framework/pull/2762
• .NET: [Breaking] Prevent loss of input messages & streamed updates when resuming streaming by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/2748
• .NET: Bump Microsoft.Agents.AI.Workflows from 1.0.0-preview.251125.1 to 1.0.0-preview.251219.1 by @dependabot[bot] in https://github.com/microsoft/agent-framework/pull/2997
• .NET: Add Run overloads to expose ChatClientAgentRunOptions in IntelliSense by @Copilot in https://github.com/microsoft/agent-framework/pull/3115
• .NET: Bump Google.GenAI from 0.6.0 to 0.9.0 by @dependabot[bot] in https://github.com/microsoft/agent-framework/pull/2995
• .NET: Updated package versions by @dmytrostruk in https://github.com/microsoft/agent-framework/pull/3144
• .NET: Bump Microsoft.Agents.AI.OpenAI and Microsoft.Extensions.AI.OpenAI by @dependabot[bot] in https://github.com/microsoft/agent-framework/pull/2996

Full Changelog: https://github.com/microsoft/agent-framework/compare/dotnet-1.0.0-preview.251219.1...dotnet-1.0.0-preview.260108.1