Agent Framework Release Notes

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 CHANGELOG with 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 vite from 7.3.1 to 7.3.2 in /python/samples/05-end-to-end/ag_ui_workflow_handoff/frontend (#5132)
• python: Bump cryptography from 46.0.6 to 46.0.7 (#5176)
• python: Bump mcp from 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 TypeVar annotations (#4944)
• agent-framework-openai: Fix response_format crash on background polling with empty text (#5146)
• agent-framework-foundry: Strip tools from FoundryAgent request when agent_reference is 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.done and response.reasoning_summary_text.done events (#5162)

Full Changelog: python-1.0.0...python-1.0.1

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.

[1.0.0] - 2026-04-02

Important

For any breaking changes & updates, please view this migration guide.

Added

• repo: Add PACKAGE_STATUS.md to 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.0rc6 to 1.0.0 (Production/Stable) (#5062)
• agent-framework-core, agent-framework-openai, agent-framework-foundry: [BREAKING] Dependency floors now require released >=1.0.0,<2 packages, 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.0b260330 to 1.0.0b260402 (#5062)
• docs: Update install instructions to drop --pre flag for released packages (#5062)

Removed

• agent-framework-core: [BREAKING] Remove deprecated BaseContextProvider and BaseHistoryProvider aliases (#5062)
• agent-framework-core: [BREAKING] Remove deprecated text parameter from Message constructor (#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=...) to Message(contents=[...]) throughout codebase (#5062)
• agent-framework-devui: Accept legacy payload formats (text, message, content, input, data) and convert to framework-native Message(contents=...) (#5062)
• samples: Fix Foundry samples to use env vars consistently and update install guidance (#5062)

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.

What's Changed

.NET: Include ReasoningEncryptedContent by default when stored output disabled with Responses by @westey-m in #4623
.NET: Update A2A, MCP, and system package dependencies by @SergeyMenshykh in #4647
.NET: Fix to emit WorkflowStartedEvent during workflow execution by @peibekwe in #4514
.NET: Address Suppress Experimental Features for Docker Build by @rogerbarreto in #4641
.NET: Sanitize user input in log statements for durable agent samples by @kshyju in #4656
.NET: [Durable Agents] Filter empty AIContent from durable agent state responses by @cgillum in #4670
.NET - Fix flaky workflows test by @Copilot in #4700
.NET: Add durable workflow support by @kshyju in #4436
Bump actions/setup-dotnet from 5.1.0 to 5.2.0 by @dependabot[bot] in #4541
Bump danielpalme/ReportGenerator-GitHub-Action from 5.5.1 to 5.5.3 by @dependabot[bot] in #4542
Bump MishaKav/pytest-coverage-comment from 1.2.0 to 1.6.0 by @dependabot[bot] in #4543
Bump actions/upload-artifact from 4 to 7 by @dependabot[bot] in #4373
.NET: Align sample build configuration with test runner in CI by @kshyju in #4735
.NET: Fix race condition issue in FanInEdge while processing messages. by @peibekwe in #4662
.NET Compaction - Add AsChatReducer() extension to expose CompactionStrategy as IChatReducer by @Copilot in #4664
.NET Compaction - Allow developer to specify a custom formatter for ToolResultCompactionStrategy by @Copilot in #4667
.NET: Validate SkillsInstructionPrompt contains {0} placeholder in FileAgentSkillsProvider by @moonbox3 in #4642
.NET: Fix source generator bug that silently drops base class handler registrations for protocol-only partial executors by @peibekwe in #4751
.NET: Trim src references and add utility to enforce by @westey-m in #4693
Add docker-in-docker feature to dev container by @westey-m in #4794
Add automated stale issue and PR follow-up ping workflow by @moonbox3 in #4776
.NET: Update to OpenAI 2.9.1, Azure.AI.OpenAI 2.9.0-beta.1, Microsoft.Extensions.AI 10.4.0, and Azure.AI.Projects 2.0.0-beta.2 by @Copilot in #4613
.NET: Improve visibility for AzureFunctions Workflows samples run tests in increase timeouts by @westey-m in #4820
.NET: Obsolete the V1 helper methods and migrate samples using it where possible by @westey-m in #4795
Add ADR-0020: Foundry Evals integration by @alliscode in #4731
.NET: Fix broken workflow samples by @peibekwe in #4800
.NET: Bump Azure.AI.Agents.Persistent from 1.2.0-beta.9 to 1.2.0-beta.10 by @dependabot[bot] in #4833
.NET: Update Hosted Samples References to latest beta.11 by @rogerbarreto in #4853
.NET: Mark constructors of InvokingContext and InvokedContext as experimental by @westey-m in #4851
Bump actions/download-artifact from 7 to 8 by @dependabot[bot] in #4372
.NET: Re-enable AzureAI.Persistent packaging and integration tests by @rogerbarreto in #4865
.NET: Update AIContextProviders to use Microsoft.Extensions.Compliance.Redaction by @westey-m in #4854
.NET: Persist messages during function call loop by @westey-m in #4762
.NET: [BREAKING] Fix FileSystemJsonCheckpointStore support for sessionIds with path-forbidden or special characters by @lokitoth in #4730
.NET: Expose workflows as MCP tools when hosting on Azure functions by @kshyju in #4768
.NET: Clarify IResettableExecutor usage comment in workflow sample by @peibekwe in #4905
.NET: Pass through external input request and handle response conversion for workflow as agent scenario by @peibekwe in #4361
.NET: Fix ChatOptions mutation in AIContextProviderChatClient across calls by @chetantoshniwal in #4891
.NET: [BREAKING] Update type names and source generator to reduce conflicts by @lokitoth in #4903
.NET: fix: HandoffAgentExecutor does not output any response when non-streaming by @lokitoth in #4745
.NET: Re-enable the "retrieve object" check in StateManager by @lokitoth in #1881
Add ADR to decide consistency of Chat History Persistence by @westey-m in #4816
ADR to support a multi-source architecture for agent skills by @SergeyMenshykh in #4787
.NET: Add AsIChatClientWithStoredOutputDisabled for ProjectResponsesClient by @rogerbarreto in #4911
.NET: Add integration test validating OpenAPI tools with AsAIAgent(agentVersion) by @rogerbarreto in #4931
.NET: Fix role assignment in ChatMessage construction by @AkiKurisu in #4290
.NET: Samples fix by @westey-m in #4932
.NET: Improve observability sample by @TaoChenOSU in #4917
.NET: Fix bug with per-service-call persistence and approvals by @westey-m in #4933
.NET: feat: Implement return-to-previous routing in handoff workflow by @lokitoth in #4356
.NET: [Breaking] Restructure agent skills to use multi-source architecture by @SergeyMenshykh in #4871
.NET: Fixes for durable agents integration tests by @westey-m in #4952
.NET: Skip flaky integration tests blocking merge queue by @rogerbarreto in #4972
.NET: [Breaking] Update Foundry Agents for Responses API by @rogerbarreto in #4502
.NET: BugFix #3433 ChatClientAgent streaming responses missing messageid by @rogerbarreto in #4615
.NET: Add inline skills API by @SergeyMenshykh in #4951
.NET: Suppress CodeQL false positive by @westey-m in #4948
.NET: Add API breaking change validation for RC packages by @rogerbarreto in #4977
.NET: Allow Simulating service stored ChatHistory to improve consistency by @westey-m in #4974
.NET: Fix broken url in samples by @westey-m in #4981
.NET: Updated package versions by @rogerbarreto in #4982

New Contributors

@hgvfhsrtyvrt456vtg made their first contribution in #4598
@cecheta made their first contribution in #3985
@huimiu made their first contribution in #4648
@jsturtevant made their first contribution in #4711
@chetantoshniwal made their first contribution in #4891
@AkiKurisu made their first contribution in #4290

Full Changelog: dotnet-1.0.0-rc4...dotnet-1.0.0-rc5

[1.0.0rc6] - 2026-03-30

Important

For any breaking changes & updates, please view this migration guide.

Added

• agent-framework-openai: New package extracted from core for OpenAI and Azure OpenAI provider support (#4818)
• agent-framework-foundry: New package for Azure AI Foundry integration (#4818)
• agent-framework-core: Support structuredContent in MCP tool results and fix sampling options type (#4763)
• agent-framework-core: Include reasoning messages in MESSAGES_SNAPSHOT events (#4844)
• agent-framework-core: [BREAKING] Add context mode to AgentExecutor (#4668)

Changed

• agent-framework-core: [BREAKING] Remove deprecated kwargs compatibility paths (#4858)
• agent-framework-core: [BREAKING] Reduce core dependencies and simplify optional integrations (#4904)
• agent-framework-openai: [BREAKING] Provider-leading client design & OpenAI package extraction (#4818)
• agent-framework-openai: [BREAKING] Fix OpenAI Azure routing and provider samples (#4925)
• agent-framework-azure-ai: Deprecate Azure AI v1 (Persistent Agents API) helper methods (#4804)
• agent-framework-core: Avoid duplicate agent response telemetry (#4685)
• agent-framework-devui: Bump flatted from 3.3.3 to 3.4.2 in frontend (#4805)
• samples: Move ag_ui_workflow_handoff demo from demos/ to 05-end-to-end/ (#4900)

Fixed

• agent-framework-core: Fix streaming path to emit mcp_server_tool_result on output_item.done instead of output_item.added (#4821)
• agent-framework-a2a: Fix A2AAgent to surface message content from in-progress TaskStatusUpdateEvents (#4798)
• agent-framework-core: Fix PydanticSchemaGenerationError when using from future import annotations with @tool (#4822)
• samples: Fix broken samples for GitHub Copilot, declarative, and Responses API (#4915)
• repo: Fix: update PyRIT repository link from Azure/PyRIT to microsoft/PyRIT (#4960)

[1.0.0rc5] - 2026-03-19

Important

For any breaking changes & updates, please view this migration guide.

Added

• samples: Add foundry hosted agents samples for python (#4648)
• repo: Add automated stale issue and PR follow-up ping workflow (#4776)
• agent-framework-ag-ui: Emit AG-UI events for MCP tool calls, results, and text reasoning (#4760)
• agent-framework-ag-ui: Emit TOOL_CALL_RESULT events when resuming after tool approval (#4758)

Changed

• agent-framework-devui: Bump minimatch from 3.1.2 to 3.1.5 in frontend (#4337)
• agent-framework-devui: Bump rollup from 4.47.1 to 4.59.0 in frontend (#4338)
• agent-framework-core: Unify tool results as Content items with rich content support (#4331)
• agent-framework-a2a: Default A2AAgent name and description from AgentCard (#4661)
• agent-framework-core: [BREAKING] Clean up kwargs across agents, chat clients, tools, and sessions (#4581)
• agent-framework-devui: Bump tar from 7.5.9 to 7.5.11 (#4688)
• repo: Improve Python dependency range automation (#4343)
• agent-framework-core: Normalize empty MCP tool output to null (#4683)
• agent-framework-core: Remove bad dependency (#4696)
• agent-framework-core: Keep MCP cleanup on the owner task (#4687)
• agent-framework-a2a: Preserve A2A message context_id (#4686)
• repo: Bump danielpalme/ReportGenerator-GitHub-Action from 5.5.1 to 5.5.3 (#4542)
• repo: Bump MishaKav/pytest-coverage-comment from 1.2.0 to 1.6.0 (#4543)
• agent-framework-core: Bump pyjwt from 2.11.0 to 2.12.0 (#4699)
• agent-framework-azure-ai: Reduce Azure chat client import overhead (#4744)
• repo: Simplify Python Poe tasks and unify package selectors (#4722)
• agent-framework-core: Aggregate token usage across tool-call loop iterations in invoke_agent span (#4739)
• agent-framework-core: Support detail field in OpenAI Chat API image_url payload (#4756)
• agent-framework-anthropic: [BREAKING] Refactor middleware layering and split Anthropic raw client (#4746)
• agent-framework-github-copilot: Emit tool call events in GitHubCopilotAgent streaming (4711)

Fixed

• agent-framework-core: Validate approval responses against the server-side pending request registry (#4548)
• agent-framework-devui: Validate function approval responses in the DevUI executor (#4598)
• agent-framework-azurefunctions: Use deepcopy for state snapshots so nested mutations are detected in durable workflow activities (#4518)
• agent-framework-bedrock: Fix BedrockChatClient sending invalid toolChoice "none" to the Bedrock API (#4535)
• agent-framework-core: Fix type hint for Case and Default (#3985)
• agent-framework-core: Fix duplicate tool names between supplied tools and MCP servers (#4649)
• agent-framework-core: Fix _deduplicate_messages catch-all branch dropping valid repeated messages (#4716)
• samples: Fix Azure Redis sample missing session for history persistence (#4692)
• agent-framework-core: Fix thread serialization for multi-turn tool calls (#4684)
• agent-framework-core: Fix RUN_FINISHED.interrupt to accumulate all interrupts when multiple tools need approval (#4717)
• agent-framework-azurefunctions: Fix missing methods on the Content class in durable tasks (#4738)
• agent-framework-core: Fix ENABLE_SENSITIVE_DATA being ignored when set after module import (#4743)
• agent-framework-a2a: Fix A2AAgent to invoke context providers before and after run (#4757)
• agent-framework-core: Fix MCP tool schema normalization for zero-argument tools missing the properties key (#4771)

Full Changelog: python-1.0.0rc4...python-1.0.0rc5

[1.0.0rc4] - 2026-03-11

Added

• agent-framework-core: Add propagate_session to as_tool() for session sharing in agent-as-tool scenarios (#4439)
• agent-framework-core: Forward runtime kwargs to skill resource functions (#4417)
• samples: Add A2A server sample (#4528)

Changed

• agent-framework-github-copilot: [BREAKING] Update integration to use ToolInvocation and ToolResult types (#4551)
• agent-framework-azure-ai: [BREAKING] Upgrade to azure-ai-projects 2.0+ (#4536)

Fixed

• agent-framework-core: Propagate MCP isError flag through the function middleware pipeline (#4511)
• agent-framework-core: Fix as_agent() not defaulting name/description from client properties (#4484)
• agent-framework-core: Exclude conversation_id from chat completions API options (#4517)
• agent-framework-core: Fix conversation ID propagation when chat_options is a dict (#4340)
• agent-framework-core: Auto-finalize ResponseStream on iteration completion (#4478)
• agent-framework-core: Prevent pickle deserialization of untrusted HITL HTTP input (#4566)
• agent-framework-core: Fix executor_completed event handling for non-copyable raw_representation in mixed workflows (#4493)
• agent-framework-core: Fix store=False not overriding client default (#4569)
• agent-framework-redis: Fix RedisContextProvider compatibility with redisvl 0.14.0 by using AggregateHybridQuery (#3954)
• samples: Fix chat_response_cancellation sample to use Message objects (#4532)
• agent-framework-purview: Fix broken link in Purview README (Microsoft 365 Dev Program URL) (#4610)

What's Changed

.NET: bug fix for duplicate output on GitHubCopilotAgent by @normalian in #3981
.NET: Increase credential timeout for Integration Tests by @westey-m in #4472
.NET: Add foundry extension samples for dotnet by @yaoleo34 in #4359
.NET: CI Build time end to end improvement by @westey-m in #4208
.NET: Switch auth sample to use Singletons by @westey-m in #4454
.NET: Add ServiceLifetime support for Hosting DI registration by @westey-m in #4476
.NET: Fix filter combine logic for ChatHistoryMemoryProvider by @westey-m in #4501
.NET: Update HostedAgents samples to Azure.AI.AgentServer.AgentFramework 1.0.0-beta.9 and MEAI 10.3.0 by @Copilot in #4477
.NET: Improve skill name validation: reject consecutive hyphens and enforce directory name match by @SergeyMenshykh in #4526
.NET: Create a sample to show bounded chat history with overflow into chat history memory by @westey-m in #4136
.NET: Update Anthropic to 12.8.0 and Anthropic.Foundry to 0.4.2 by @Copilot in #4475
.NET: Add security warnings to xml comments for core components by @westey-m in #4527
Auto-finalize ResponseStream on iteration completion by @giles17 in #4478
.NET: Skip Azure Persistent (V1) flaky CodeInterpreter integration tests by @rogerbarreto in #4583
.NET: Enable Microsoft.Agents.AI.FoundryMemory for NuGet release by @rogerbarreto in #4559
Fix Strands Agents documentation links in ADR by @Copilot in #4584
.NET: Cleanup unnecessary usages of AsIChatClient by @westey-m in #4561
.NET: Added support for polymorphic type as workflow output by @peibekwe in #4485
.NET Compaction - Introducing compaction strategies and pipeline by @crickman in #4533
.NET: SDK Patch Bump (10.0.200) - Address false positive trigger of IL2026/IL3050 diagnostics in hosting projects by @rogerbarreto in #4586
.NET: Add FinishReason to AgentResponses by @westey-m in #4617
.NET: Updated package versions by @dmytrostruk in #4632
.NET: Fixed CA1873 warning by @dmytrostruk in #4634

New Contributors

@normalian made their first contribution in #3981
@yaoleo34 made their first contribution in #4359

Full Changelog: dotnet-1.0.0-rc3...dotnet-1.0.0-rc4