microsoft/agent-framework

✨ Added

• agent-framework-core: Add `HarnessAgent` and background-agents harness provider ([#6041](https://github.com/microsoft/agent-framework/pull/6041), [#6069](https://github.com/microsoft/agent-framework/pull/6069))
• agent-framework-core, agent-framework-a2a: Add `A2AAgentSession` with referenced task IDs and input-required support ([#5980](https://github.com/microsoft/agent-framework/pull/5980))
• agent-framework-foundry: Add experimental prompt-agent conversion and deployment APIs ([#5959](https://github.com/microsoft/agent-framework/pull/5959))
• agent-framework-declarative: Add Foundry Toolbox MCP invocation support and sample ([#5933](https://github.com/microsoft/agent-framework/pull/5933))
• samples: Add hosting samples overview README ([#5407](https://github.com/microsoft/agent-framework/pull/5407))

📋 Changed

• agent-framework-core: Align TodoProvider tool names with the C# implementation ([#6107](https://github.com/microsoft/agent-framework/pull/6107))
• agent-framework-core: Align ModeProvider tool names and instructions ([#6071](https://github.com/microsoft/agent-framework/pull/6071))
• agent-framework-chatkit: Raise the `openai-chatkit` dependency floor to `>=1.6.4` to match the current typed API usage.
• agent-framework-declarative: [BREAKING] Remove Python-only declarative actions and rename alias kinds to C# canonical names ([#6126](https://github.com/microsoft/agent-framework/pull/6126))
• tests: Replace deprecated `asyncio.iscoroutinefunction` usage in DevUI cleanup-hook tests ([#4563](https://github.com/microsoft/agent-framework/pull/4563))

🐛 Fixed

• agent-framework-core: Point `@experimental` warnings at user code ([#5996](https://github.com/microsoft/agent-framework/pull/5996))
• agent-framework-declarative: Fix Foreach body exit wiring ([#6050](https://github.com/microsoft/agent-framework/pull/6050))
• agent-framework-devui: Fix streaming memory growth regression ([#6038](https://github.com/microsoft/agent-framework/pull/6038))
• agent-framework-foundry: Pass default headers to Foundry agents ([#6040](https://github.com/microsoft/agent-framework/pull/6040))
• agent-framework-foundry-hosting: Fix hosted handoff argument serialization ([#5861](https://github.com/microsoft/agent-framework/pull/5861))
• agent-framework-foundry-hosting: Allow hosted checkpoints to restore `MessageRole` values ([#6049](https://github.com/microsoft/agent-framework/pull/6049))
• agent-framework-openai: Preserve citation `get_url` metadata ([#6037](https://github.com/microsoft/agent-framework/pull/6037))
• agent-framework-openai: Guard Chat Completions streaming against null deltas ([#5734](https://github.com/microsoft/agent-framework/pull/5734))
• + 3 more

✨ Added

• agent-framework-core: Shell tool with support for local and Docker execution ([#5664](https://github.com/microsoft/agent-framework/pull/5664))
• agent-framework-monty: New Monty-backed CodeAct provider package ([#5915](https://github.com/microsoft/agent-framework/pull/5915))
• agent-framework-foundry: Add experimental hosted tool factories on `FoundryChatClient` ([#5958](https://github.com/microsoft/agent-framework/pull/5958))
• agent-framework-foundry: Include tool definitions for Foundry agent evals ([#5974](https://github.com/microsoft/agent-framework/pull/5974))
• agent-framework-a2a: Use non-streaming transport and `return_immediately` for background ops ([#5963](https://github.com/microsoft/agent-framework/pull/5963))

📋 Changed

• agent-framework-core, agent-framework-foundry: [BREAKING] Enable instrumentation by default ([#5865](https://github.com/microsoft/agent-framework/pull/5865))
• agent-framework-foundry: Show more authentication methods in Foundry Toolbox MCP ([#5719](https://github.com/microsoft/agent-framework/pull/5719))

🐛 Fixed

• agent-framework-core: Skip MCP prompt loading when unsupported ([#5370](https://github.com/microsoft/agent-framework/pull/5370))

✨ Added

• agent-framework-core, agent-framework-foundry, agent-framework-openai: Record actual served model from Azure OpenAI ([#5910](https://github.com/microsoft/agent-framework/pull/5910))
• samples: New Foundry Hosted Agents samples for RAG, Skills, and Memory ([#5822](https://github.com/microsoft/agent-framework/pull/5822))

📋 Changed

• agent-framework-core, agent-framework-azurefunctions, agent-framework-devui, agent-framework-foundry, agent-framework-orchestrations: Improve handling of intermediate outputs for workflows and orchestrations ([#5623](https://github.com/microsoft/agent-framework/pull/5623))
• agent-framework-durabletask: Pin `durabletask` and `durabletask-azuremanaged` floors to `>=1.4.0` and exclude upstream `durabletask` 1.4.1, 1.4.2, and 1.4.3 from the supported version range.
• agent-framework-orchestrations: Bumped package to release candidate stage.

🐛 Fixed

• agent-framework-core: Parse YAML block scalars in SKILL.md frontmatter ([#5863](https://github.com/microsoft/agent-framework/pull/5863))
• agent-framework-github-copilot: Include tools added by `ContextProvider.before_run` in session creation ([#5780](https://github.com/microsoft/agent-framework/pull/5780))
• agent-framework-hyperlight: Skip symlinks when staging sandbox input ([#5919](https://github.com/microsoft/agent-framework/pull/5919))
• agent-framework-purview: Remove duplicate pop in `InMemoryCacheProvider.remove` ([#5795](https://github.com/microsoft/agent-framework/pull/5795))
• Full Changelog: https://github.com/microsoft/agent-framework/compare/python-1.4.0...python-1.5.0

✨ Added

• agent-framework-core: Forward MCP tool call metadata ([#5815](https://github.com/microsoft/agent-framework/pull/5815))
• agent-framework-core: Support `list[str]` arguments for file-based skill scripts ([#5850](https://github.com/microsoft/agent-framework/pull/5850))
• agent-framework-core: Strip server-issued response item IDs under storage ([#5690](https://github.com/microsoft/agent-framework/pull/5690))
• agent-framework-ag-ui: Add tool result display channel ([#5762](https://github.com/microsoft/agent-framework/pull/5762))
• agent-framework-ag-ui: Promote to release candidate stage ([#5844](https://github.com/microsoft/agent-framework/pull/5844))
• agent-framework-devui: Improvements for DevUI ([#5840](https://github.com/microsoft/agent-framework/pull/5840))

📋 Changed

• agent-framework-core: [BREAKING] — experimental skills API] Align file skill folder discovery with agentskills.io spec ([#5807](https://github.com/microsoft/agent-framework/pull/5807))
• agent-framework-core: [BREAKING] — experimental skills API] Extract skill spec metadata into `SkillFrontmatter` ([#5775](https://github.com/microsoft/agent-framework/pull/5775))
• agent-framework-devui: [BREAKING] Tighten default access controls and CORS posture ([#5740](https://github.com/microsoft/agent-framework/pull/5740))
• agent-framework-a2a: [BREAKING] Migrate to a2a-sdk v1.0 ([#5752](https://github.com/microsoft/agent-framework/pull/5752))

🐛 Fixed

• agent-framework-a2a: Fix A2A v1.0 non-streaming response and sample runtime issues ([#5849](https://github.com/microsoft/agent-framework/pull/5849))
• agent-framework-foundry-hosting: Reject path-traversal context IDs in checkpoint storage ([#5851](https://github.com/microsoft/agent-framework/pull/5851))
• agent-framework-core: Prevent MCP message_handler deadlock on notification reload ([#4866](https://github.com/microsoft/agent-framework/pull/4866))

📋 What's Changed

• .NET: Add hyperlight to release slnf by @westey-m in https://github.com/microsoft/agent-framework/pull/5695
• .NET: Update FoundryAgent to address HostedAgents strict URL routing by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/5677
• .NET: Add IChatMessageInjector for message injection during function loop by @westey-m in https://github.com/microsoft/agent-framework/pull/5679
• .NET: Foundry.Hosting IT - eliminate MSBuild parallel-output races by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/5725
• .NET: Hosted-Files sample + AgentSessionFiles SDK companion + integration test by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/5698
• .NET: Simplify ClientHeadersScope to rely on AsyncLocal natural restoration by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/5676
• .NET: Hosted Agents - RAG Sample with Azure AI Search (#5693) by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/5701
• .NET: Fix/per service input persistence on stream error by @alliscode in https://github.com/microsoft/agent-framework/pull/5744
• + 23 more

📋 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
• + 14 more

✨ 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

✨ Added

• agent-framework-core: Add `ClassSkill` for class-based skill definitions with declarative metadata and automatic method discovery ([#5678](https://github.com/microsoft/agent-framework/pull/5678))
• agent-framework-core: Add experimental session-mode harness context provider ([#5611](https://github.com/microsoft/agent-framework/pull/5611))
• agent-framework-core: Add experimental todo-list harness context provider ([#5612](https://github.com/microsoft/agent-framework/pull/5612))
• agent-framework-core: Add experimental memory harness context provider ([#5613](https://github.com/microsoft/agent-framework/pull/5613))
• agent-framework-core: Notify agent of external `AgentModeProvider` mode changes ([#5650](https://github.com/microsoft/agent-framework/pull/5650))
• agent-framework-core: Information-flow control prompt injection defense ([#5331](https://github.com/microsoft/agent-framework/pull/5331))
• agent-framework-openai: Support OpenAI and Gemini `allowed_tools` tool choice ([#5322](https://github.com/microsoft/agent-framework/pull/5322))
• agent-framework-openai: Support GPT-5 verbosity option and restore Foundry `agent_reference` ([#5619](https://github.com/microsoft/agent-framework/pull/5619))
• + 8 more

📋 Changed

• agent-framework-core: [BREAKING — experimental skills API] Restructure agent skills to use multi-source architecture ([#5584](https://github.com/microsoft/agent-framework/pull/5584))
• agent-framework-foundry: Remove bespoke Foundry toolbox helpers; standardize on MCP for toolbox consumption ([#5671](https://github.com/microsoft/agent-framework/pull/5671))

🐛 Fixed

• agent-framework-core: Fix `MCPStreamableHTTPTool` leaking `asyncio.CancelledError` when MCP server is unreachable ([#5687](https://github.com/microsoft/agent-framework/pull/5687))
• agent-framework-openai: Drop completed `continuation_token` from shared options in tool loop ([#5462](https://github.com/microsoft/agent-framework/pull/5462))
• agent-framework-bedrock: Don't send `toolChoice` when no tools are configured ([#5172](https://github.com/microsoft/agent-framework/pull/5172))
• agent-framework-hyperlight: Fix `WasmSandbox` cross-thread Drop and harden hosted-agent sample ([#5603](https://github.com/microsoft/agent-framework/pull/5603))
• agent-framework-devui: Fix incorrect workflow timings by adding `created_at` to executor events ([#5615](https://github.com/microsoft/agent-framework/pull/5615))
• agent-framework-foundry-hosting: Fix hosted MCP replay producing orphan `function_call_output` ([#5581](https://github.com/microsoft/agent-framework/pull/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
• + 5 more

✨ 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](https://github.com/microsoft/agent-framework/pull/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](https://github.com/microsoft/agent-framework/pull/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](https://github.com/microsoft/agent-framework/pull/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](https://github.com/microsoft/agent-framework/pull/5531))
• dependencies: Update workspace package dependencies and preserve `mcp[ws]` / `uvicorn[standard]` extras through override-dependencies in `/python` ([#5555](https://github.com/microsoft/agent-framework/pull/5555))

🐛 Fixed

• agent-framework-core: Fix observability spans not being correctly nested when using streaming ([#5552](https://github.com/microsoft/agent-framework/pull/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](https://github.com/microsoft/agent-framework/pull/5557))
• Full Changelog: https://github.com/microsoft/agent-framework/compare/python-1.2.1...python-1.2.2

✨ 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](https://github.com/microsoft/agent-framework/pull/5485))
• samples: Add `requirements.txt` and `.env.example` to the `a2a/` hosting sample for pip-based setup ([#5510](https://github.com/microsoft/agent-framework/pull/5510))

📋 Changed

• dependencies: Update `rich` requirement from `<15.0.0,>=13.7.1` to `>=13.7.1,<16.0.0` in `/python` ([#5227](https://github.com/microsoft/agent-framework/pull/5227))
• dependencies: Bump `prek` from `0.3.8` to `0.3.9` in `/python` ([#5228](https://github.com/microsoft/agent-framework/pull/5228))
• dependencies: Bump `python-multipart` from `0.0.22` to `0.0.26` in `/python` ([#5286](https://github.com/microsoft/agent-framework/pull/5286))
• dependencies: Bump `pyasn1` from `0.6.2` to `0.6.3` in `/python` ([#4748](https://github.com/microsoft/agent-framework/pull/4748))
• dependencies: Bump `pytest` from `9.0.2` to `9.0.3` in `/python/packages/ag-ui` ([#5461](https://github.com/microsoft/agent-framework/pull/5461))
• dependencies: Bump `pytest` from `9.0.2` to `9.0.3` in `/python/packages/devui` ([#5492](https://github.com/microsoft/agent-framework/pull/5492))
• dependencies: Bump `pytest` from `9.0.2` to `9.0.3` in `/python/packages/lab` ([#5470](https://github.com/microsoft/agent-framework/pull/5470))
• dependencies: Bump `uv` from `0.11.3` to `0.11.6` in `/python/packages/lab` ([#5469](https://github.com/microsoft/agent-framework/pull/5469))
• + 7 more

🐛 Fixed

• agent-framework-core: Prevent `inner_exception` from being lost in `AgentFrameworkException` ([#5167](https://github.com/microsoft/agent-framework/pull/5167))
• Full Changelog: https://github.com/microsoft/agent-framework/compare/python-1.2.0...python-1.2.1

✨ Added

• agent-framework-core: Add functional workflow API ([#4238](https://github.com/microsoft/agent-framework/pull/4238))
• agent-framework-core, agent-framework-github-copilot: Add OpenTelemetry integration for `GitHubCopilotAgent` ([#5142](https://github.com/microsoft/agent-framework/pull/5142))
• agent-framework-a2a: Add Agent Framework to A2A bridge support ([#2403](https://github.com/microsoft/agent-framework/pull/2403))
• agent-framework-foundry: Surface `oauth_consent_request` events from Responses API in Foundry clients ([#5070](https://github.com/microsoft/agent-framework/pull/5070))

📋 Changed

• agent-framework-core, agent-framework-foundry: Update `FoundryAgent` for hosted agent sessions ([#5447](https://github.com/microsoft/agent-framework/pull/5447))
• agent-framework-foundry-hosting: Upgrade hosting server dependency and add more type support ([#5459](https://github.com/microsoft/agent-framework/pull/5459))

🐛 Fixed

• agent-framework-ag-ui: Fix reasoning role and multimodal media parsing to follow specification ([#5389](https://github.com/microsoft/agent-framework/pull/5389))
• agent-framework-foundry: Stop emitting `[TOOLBOXES]` warning for every `FoundryChatClient` call ([#5440](https://github.com/microsoft/agent-framework/pull/5440))
• agent-framework-anthropic, agent-framework-azure-ai-search, agent-framework-azure-cosmos: Fix user agent prefix ([#5455](https://github.com/microsoft/agent-framework/pull/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

✨ Added

• agent-framework-core: Add `expected_output` ground-truth support to `evaluate_workflow` for similarity evaluators ([#5234](https://github.com/microsoft/agent-framework/pull/5234))
• agent-framework-ag-ui, agent-framework-a2a: Propagate `thread_id` and `forwarded_props` through AG-UI to A2A `context_id` ([#5383](https://github.com/microsoft/agent-framework/pull/5383))
• samples: Add second approval-required tool (`set_stop_loss`) to `concurrent_builder_tool_approval` sample ([#4875](https://github.com/microsoft/agent-framework/pull/4875))
• agent-framework-core: Add `SKIP_PARSING` sentinel for `FunctionTool.invoke` to bypass `Content`-wrapping and return raw function results ([#5424](https://github.com/microsoft/agent-framework/pull/5424))

📋 Changed

• agent-framework-foundry-hosting: Correct Development Status classifier from Beta (4) to Alpha (3) to match the package's lifecycle stage ([#5387](https://github.com/microsoft/agent-framework/pull/5387))
• tests: Add Python flaky test report workflow ([#5342](https://github.com/microsoft/agent-framework/pull/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](https://github.com/microsoft/agent-framework/pull/5424))

🐛 Fixed

• agent-framework-openai: Fix OpenAI Responses streaming to propagate `created_at` from the final `response.completed` event ([#5382](https://github.com/microsoft/agent-framework/pull/5382))
• agent-framework-openai: Fix `OpenAIEmbeddingClient` to use `AsyncOpenAI` for `/openai/v1` endpoints ([#5137](https://github.com/microsoft/agent-framework/pull/5137))
• agent-framework-openai: Exclude null `file_id` from `input_image` payload to prevent schema 400 errors ([#5125](https://github.com/microsoft/agent-framework/pull/5125))
• agent-framework-foundry: Reconcile Toolbox hosted-tool payloads with the Responses API ([#5414](https://github.com/microsoft/agent-framework/pull/5414))
• agent-framework-ag-ui: Pass client `thread_id` as `session_id` when constructing `AgentSession` ([#5384](https://github.com/microsoft/agent-framework/pull/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](https://github.com/microsoft/agent-framework/pull/5424))
• Full Changelog: https://github.com/microsoft/agent-framework/compare/python-1.1.0...python-1.1.1

✨ Added

• agent-framework-gemini: Add `GeminiChatClient` ([#4847](https://github.com/microsoft/agent-framework/pull/4847))
• agent-framework-core: Add `context_providers` and `description` to `workflow.as_agent()` ([#4651](https://github.com/microsoft/agent-framework/pull/4651))
• agent-framework-core: Add experimental file history provider ([#5248](https://github.com/microsoft/agent-framework/pull/5248))
• agent-framework-core: Add OpenAI types to the default checkpoint encoding allow list ([#5297](https://github.com/microsoft/agent-framework/pull/5297))
• agent-framework-core: Add `AgentExecutorResponse.with_text()` to preserve conversation history through custom executors ([#5255](https://github.com/microsoft/agent-framework/pull/5255))
• agent-framework-a2a: Propagate A2A metadata from `Message`, `Artifact`, `Task`, and event types ([#5256](https://github.com/microsoft/agent-framework/pull/5256))
• agent-framework-core: Add `finish_reason` support to `AgentResponse` and `AgentResponseUpdate` ([#5211](https://github.com/microsoft/agent-framework/pull/5211))
• agent-framework-hyperlight: Add Hyperlight CodeAct package and docs ([#5185](https://github.com/microsoft/agent-framework/pull/5185))
• + 4 more

📋 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](https://github.com/microsoft/agent-framework/issues/5200))
• agent-framework-core: Improve skill name validation ([#4530](https://github.com/microsoft/agent-framework/pull/4530))
• agent-framework-azure-cosmos: Add `allowed_checkpoint_types` support to `CosmosCheckpointStorage` for parity with `FileCheckpointStorage` ([#5202](https://github.com/microsoft/agent-framework/pull/5202))
• agent-framework-core: Move `InMemory` history provider injection to first invocation ([#5236](https://github.com/microsoft/agent-framework/pull/5236))
• agent-framework-github-copilot: Forward provider config to `SessionConfig` in `GitHubCopilotAgent` ([#5195](https://github.com/microsoft/agent-framework/pull/5195))
• agent-framework-hyperlight-codeact: Flatten `execute_code` output ([#5333](https://github.com/microsoft/agent-framework/pull/5333))
• dependencies: Bump `pygments` from `2.19.2` to `2.20.0` in `/python` ([#4978](https://github.com/microsoft/agent-framework/pull/4978))
• tests: Bump misc integration retry delay to 30s ([#5293](https://github.com/microsoft/agent-framework/pull/5293))
• + 2 more

🐛 Fixed

• agent-framework-core: Fix `python-feature-lifecycle` skill YAML frontmatter ([#5226](https://github.com/microsoft/agent-framework/pull/5226))
• agent-framework-core: Fix `HandoffBuilder` dropping function-level middleware when cloning agents ([#5220](https://github.com/microsoft/agent-framework/pull/5220))
• agent-framework-ag-ui: Fix deterministic state updates from tool results ([#5201](https://github.com/microsoft/agent-framework/pull/5201))
• agent-framework-devui: Fix streaming memory growth and add cross-platform regression coverage ([#5221](https://github.com/microsoft/agent-framework/pull/5221))
• agent-framework-core: Skip `get_final_response` in `_finalize_stream` when the stream has errored ([#5232](https://github.com/microsoft/agent-framework/pull/5232))
• agent-framework-openai: Fix reasoning replay when `store=False` ([#5250](https://github.com/microsoft/agent-framework/pull/5250))
• agent-framework-foundry: Handle `url_citation` annotations in `FoundryChatClient` streaming responses ([#5071](https://github.com/microsoft/agent-framework/pull/5071))
• agent-framework-gemini: Fix Gemini client support for Gemini API and Vertex AI ([#5258](https://github.com/microsoft/agent-framework/pull/5258))
• + 2 more

📋 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 ]
• + 50 more

🐛 Fixed

• agent-framework-devui: Fix streaming memory growth in DevUI frontend ([#5221](https://github.com/microsoft/agent-framework/pull/5221))

📦 1.0.1 - 2026-04-09

• > [!IMPORTANT]

✨ Added

• samples: Add sample documentation for two separate Neo4j context providers for retrieval and memory ([#4010](https://github.com/microsoft/agent-framework/pull/4010))
• agent-framework-azure-cosmos: Add Cosmos DB NoSQL checkpoint storage for Python workflows ([#4916](https://github.com/microsoft/agent-framework/pull/4916))

📋 Changed

• docs: Remove pre-release flag from agent-framework installation instructions ([#5082](https://github.com/microsoft/agent-framework/pull/5082))
• samples: Revise agent examples in `README.md` ([#5067](https://github.com/microsoft/agent-framework/pull/5067))
• repo: Update `CHANGELOG` with v1.0.0 release ([#5069](https://github.com/microsoft/agent-framework/pull/5069))
• agent-framework-core: [BREAKING] Fix handoff workflow context management and improve AG-UI demo ([#5136](https://github.com/microsoft/agent-framework/pull/5136))
• agent-framework-core: Restrict persisted checkpoint deserialization by default ([#4941](https://github.com/microsoft/agent-framework/pull/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](https://github.com/microsoft/agent-framework/pull/5132))
• python: Bump `cryptography` from 46.0.6 to 46.0.7 ([#5176](https://github.com/microsoft/agent-framework/pull/5176))
• python: Bump `mcp` from 1.26.0 to 1.27.0 ([#5117](https://github.com/microsoft/agent-framework/pull/5117))
• + 1 more

🐛 Fixed

• agent-framework-core: Raise clear handler registration error for unresolved `TypeVar` annotations ([#4944](https://github.com/microsoft/agent-framework/pull/4944))
• agent-framework-openai: Fix `response_format` crash on background polling with empty text ([#5146](https://github.com/microsoft/agent-framework/pull/5146))
• agent-framework-foundry: Strip tools from `FoundryAgent` request when `agent_reference` is present ([#5101](https://github.com/microsoft/agent-framework/pull/5101))
• agent-framework-core: Fix test compatibility for entity key validation ([#5179](https://github.com/microsoft/agent-framework/pull/5179))
• agent-framework-openai: Stop emitting duplicate reasoning content from `response.reasoning_text.done` and `response.reasoning_summary_text.done` events ([#5162](https://github.com/microsoft/agent-framework/pull/5162))
• Full Changelog: https://github.com/microsoft/agent-framework/compare/python-1.0.0...python-1.0.1

📋 Changes:

• 3e864cdb4c6031cf93096fa6af4d927b31126d8a .NET: Update version to 1.1.0 (#5204)
• 14d2ab3262580a383472b406d97b36cfd86b2787 Standardize file skills terminology on 'directory' (#5205)
• e5f7b9c260961916e108ca10780988aeefd51662 .NET: Support reflection for discovery of resources and scripts in class-based skills (#5183)
• <details><summary><b>See More</b></summary>
• 1dd828d25502a1d4b4facff8e278da0668b40d28 CHANGELOG Update with V1.0.0 Release (#5069)
• 8348584ac29f91a2c5e5e3db05166add1bb7b2af VerifySamples: Filter projects to net10 only (#5184)
• 6d6cb840aec8b85c6bb5e95dc680c8fdd6110394 .NET: Improve resilience of verify-samples by building separately and improving evaluation instructions (#5151)
• 79afda1a6c4103baa5ae3a42b3004a9e1d28f892 Samples fixes (#5169)
• + 18 more

📦 [1.0.0] - 2026-04-02

• >[!IMPORTANT]
• > For any breaking changes & updates, please view this [migration guide](https://learn.microsoft.com/en-us/agent-framework/support/upgrade/python-2026-significant-changes).

✨ Added

• repo: Add `PACKAGE_STATUS.md` to track lifecycle status of all Python packages ([#5062](https://github.com/microsoft/agent-framework/pull/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](https://github.com/microsoft/agent-framework/pull/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](https://github.com/microsoft/agent-framework/pull/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](https://github.com/microsoft/agent-framework/pull/5062))
• docs: Update install instructions to drop `--pre` flag for released packages ([#5062](https://github.com/microsoft/agent-framework/pull/5062))

🗑️ Removed

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

📋 Changes:

• c798cb7a2ecd675c898db84931fb700060bceb77 release: Mark Handoff Orchestrations Experimental (#5065)
• 524c0216e45a1b6e09b3e2816321c23a4ef57962 .NET: Update release versions (#5059)
• 281661e4097868f75cef5219353b1ddb3106a081 .NET: Remove timeout from InputWait in OffThread execution (#4996)
• b0613a8cebdee0e67f81acb1553d9cc1f9318c2b .NET: Bump Azure.AI.Projects to 2.0.0 GA (#5060)
• 79b38040e8193aa9abf06a7b2f31d69f551af0af fix: Update Google.GenAI to verison compatible with M.E.AI 10.4.0+ (#5061)
• a356a165681d0ecd3583250aeff2159820269ce8 .NET: Remove OpenAIAssistantClientExtensions class (#5058)
• <details><summary><b>See More</b></summary>
• 628bb1af48ea264d17147f30190c1e745da309f7 .NET: Rename Microsoft.Agents.AI.AzureAI to Microsoft.Agents.AI.Foundry and consolidate FoundryMemory (#5042)
• + 14 more

📋 What's Changed

• .NET: Include ReasoningEncryptedContent by default when stored output disabled with Responses by @westey-m in https://github.com/microsoft/agent-framework/pull/4623
• .NET: Update A2A, MCP, and system package dependencies by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/4647
• .NET: Fix to emit WorkflowStartedEvent during workflow execution by @peibekwe in https://github.com/microsoft/agent-framework/pull/4514
• .NET: Address Suppress Experimental Features for Docker Build by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/4641
• .NET: Sanitize user input in log statements for durable agent samples by @kshyju in https://github.com/microsoft/agent-framework/pull/4656
• .NET: [Durable Agents] Filter empty AIContent from durable agent state responses by @cgillum in https://github.com/microsoft/agent-framework/pull/4670
• .NET - Fix flaky workflows test by @Copilot in https://github.com/microsoft/agent-framework/pull/4700
• .NET: Add durable workflow support by @kshyju in https://github.com/microsoft/agent-framework/pull/4436
• + 53 more

✨ New Contributors

• @hgvfhsrtyvrt456vtg made their first contribution in https://github.com/microsoft/agent-framework/pull/4598
• @cecheta made their first contribution in https://github.com/microsoft/agent-framework/pull/3985
• @huimiu made their first contribution in https://github.com/microsoft/agent-framework/pull/4648
• @jsturtevant made their first contribution in https://github.com/microsoft/agent-framework/pull/4711
• @chetantoshniwal made their first contribution in https://github.com/microsoft/agent-framework/pull/4891
• @AkiKurisu made their first contribution in https://github.com/microsoft/agent-framework/pull/4290
• Full Changelog: https://github.com/microsoft/agent-framework/compare/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](https://learn.microsoft.com/en-us/agent-framework/support/upgrade/python-2026-significant-changes).

✨ Added

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

📋 Changed

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

🐛 Fixed

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

📦 [1.0.0rc5] - 2026-03-19

• >[!IMPORTANT]
• > For any breaking changes & updates, please view this [migration guide](https://learn.microsoft.com/en-us/agent-framework/support/upgrade/python-2026-significant-changes).

✨ Added

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

📋 Changed

• agent-framework-devui: Bump minimatch from 3.1.2 to 3.1.5 in frontend ([#4337](https://github.com/microsoft/agent-framework/pull/4337))
• agent-framework-devui: Bump rollup from 4.47.1 to 4.59.0 in frontend ([#4338](https://github.com/microsoft/agent-framework/pull/4338))
• agent-framework-core: Unify tool results as `Content` items with rich content support ([#4331](https://github.com/microsoft/agent-framework/pull/4331))
• agent-framework-a2a: Default `A2AAgent` name and description from `AgentCard` ([#4661](https://github.com/microsoft/agent-framework/pull/4661))
• agent-framework-core: [BREAKING] Clean up kwargs across agents, chat clients, tools, and sessions ([#4581](https://github.com/microsoft/agent-framework/pull/4581))
• agent-framework-devui: Bump tar from 7.5.9 to 7.5.11 ([#4688](https://github.com/microsoft/agent-framework/pull/4688))
• repo: Improve Python dependency range automation ([#4343](https://github.com/microsoft/agent-framework/pull/4343))
• agent-framework-core: Normalize empty MCP tool output to `null` ([#4683](https://github.com/microsoft/agent-framework/pull/4683))
• + 12 more

🐛 Fixed

• agent-framework-core: Validate approval responses against the server-side pending request registry ([#4548](https://github.com/microsoft/agent-framework/pull/4548))
• agent-framework-devui: Validate function approval responses in the DevUI executor ([#4598](https://github.com/microsoft/agent-framework/pull/4598))
• agent-framework-azurefunctions: Use `deepcopy` for state snapshots so nested mutations are detected in durable workflow activities ([#4518](https://github.com/microsoft/agent-framework/pull/4518))
• agent-framework-bedrock: Fix `BedrockChatClient` sending invalid toolChoice `"none"` to the Bedrock API ([#4535](https://github.com/microsoft/agent-framework/pull/4535))
• agent-framework-core: Fix type hint for `Case` and `Default` ([#3985](https://github.com/microsoft/agent-framework/pull/3985))
• agent-framework-core: Fix duplicate tool names between supplied tools and MCP servers ([#4649](https://github.com/microsoft/agent-framework/pull/4649))
• agent-framework-core: Fix `_deduplicate_messages` catch-all branch dropping valid repeated messages ([#4716](https://github.com/microsoft/agent-framework/pull/4716))
• samples: Fix Azure Redis sample missing session for history persistence ([#4692](https://github.com/microsoft/agent-framework/pull/4692))
• + 7 more

✨ Added

• agent-framework-core: Add `propagate_session` to `as_tool()` for session sharing in agent-as-tool scenarios ([#4439](https://github.com/microsoft/agent-framework/pull/4439))
• agent-framework-core: Forward runtime kwargs to skill resource functions ([#4417](https://github.com/microsoft/agent-framework/pull/4417))
• samples: Add A2A server sample ([#4528](https://github.com/microsoft/agent-framework/pull/4528))

📋 Changed

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

🐛 Fixed

• agent-framework-core: Propagate MCP `isError` flag through the function middleware pipeline ([#4511](https://github.com/microsoft/agent-framework/pull/4511))
• agent-framework-core: Fix `as_agent()` not defaulting name/description from client properties ([#4484](https://github.com/microsoft/agent-framework/pull/4484))
• agent-framework-core: Exclude `conversation_id` from chat completions API options ([#4517](https://github.com/microsoft/agent-framework/pull/4517))
• agent-framework-core: Fix conversation ID propagation when `chat_options` is a dict ([#4340](https://github.com/microsoft/agent-framework/pull/4340))
• agent-framework-core: Auto-finalize `ResponseStream` on iteration completion ([#4478](https://github.com/microsoft/agent-framework/pull/4478))
• agent-framework-core: Prevent pickle deserialization of untrusted HITL HTTP input ([#4566](https://github.com/microsoft/agent-framework/pull/4566))
• agent-framework-core: Fix `executor_completed` event handling for non-copyable `raw_representation` in mixed workflows ([#4493](https://github.com/microsoft/agent-framework/pull/4493))
• agent-framework-core: Fix `store=False` not overriding client default ([#4569](https://github.com/microsoft/agent-framework/pull/4569))
• + 3 more

📋 What's Changed

• .NET: bug fix for duplicate output on GitHubCopilotAgent by @normalian in https://github.com/microsoft/agent-framework/pull/3981
• .NET: Increase credential timeout for Integration Tests by @westey-m in https://github.com/microsoft/agent-framework/pull/4472
• .NET: Add foundry extension samples for dotnet by @yaoleo34 in https://github.com/microsoft/agent-framework/pull/4359
• .NET: CI Build time end to end improvement by @westey-m in https://github.com/microsoft/agent-framework/pull/4208
• .NET: Switch auth sample to use Singletons by @westey-m in https://github.com/microsoft/agent-framework/pull/4454
• .NET: Add ServiceLifetime support for Hosting DI registration by @westey-m in https://github.com/microsoft/agent-framework/pull/4476
• .NET: Fix filter combine logic for ChatHistoryMemoryProvider by @westey-m in https://github.com/microsoft/agent-framework/pull/4501
• .NET: Update HostedAgents samples to Azure.AI.AgentServer.AgentFramework 1.0.0-beta.9 and MEAI 10.3.0 by @Copilot in https://github.com/microsoft/agent-framework/pull/4477
• + 15 more

✨ New Contributors

• @normalian made their first contribution in https://github.com/microsoft/agent-framework/pull/3981
• @yaoleo34 made their first contribution in https://github.com/microsoft/agent-framework/pull/4359
• Full Changelog: https://github.com/microsoft/agent-framework/compare/dotnet-1.0.0-rc3...dotnet-1.0.0-rc4

✨ Added

• agent-framework-core: Add Shell tool ([#4339](https://github.com/microsoft/agent-framework/pull/4339))
• agent-framework-core: Add `file_ids` and `data_sources` support to `get_code_interpreter_tool()` ([#4201](https://github.com/microsoft/agent-framework/pull/4201))
• agent-framework-core: Map file citation annotations from `TextDeltaBlock` in Assistants API streaming ([#4316](https://github.com/microsoft/agent-framework/pull/4316), [#4320](https://github.com/microsoft/agent-framework/pull/4320))
• agent-framework-claude: Add OpenTelemetry instrumentation to `ClaudeAgent` ([#4278](https://github.com/microsoft/agent-framework/pull/4278), [#4326](https://github.com/microsoft/agent-framework/pull/4326))
• agent-framework-azure-cosmos: Add Azure Cosmos history provider package ([#4271](https://github.com/microsoft/agent-framework/pull/4271))
• samples: Add `auto_retry.py` sample for rate limit handling ([#4223](https://github.com/microsoft/agent-framework/pull/4223))
• tests: Add regression tests for Entry JoinExecutor workflow input initialization ([#4335](https://github.com/microsoft/agent-framework/pull/4335))

📋 Changed

• samples: Restructure and improve Python samples ([#4092](https://github.com/microsoft/agent-framework/pull/4092))
• agent-framework-orchestrations: [BREAKING] Tighten `HandoffBuilder` to require `Agent` instead of `SupportsAgentRun` ([#4301](https://github.com/microsoft/agent-framework/pull/4301), [#4302](https://github.com/microsoft/agent-framework/pull/4302))
• samples: Update workflow orchestration samples to use `AzureOpenAIResponsesClient` ([#4285](https://github.com/microsoft/agent-framework/pull/4285))

🐛 Fixed

• agent-framework-bedrock: Fix embedding test stub missing `meta` attribute ([#4287](https://github.com/microsoft/agent-framework/pull/4287))
• agent-framework-ag-ui: Fix approval payloads being re-processed on subsequent conversation turns ([#4232](https://github.com/microsoft/agent-framework/pull/4232))
• agent-framework-core: Fix `response_format` resolution in streaming finalizer ([#4291](https://github.com/microsoft/agent-framework/pull/4291))
• agent-framework-core: Strip reserved kwargs in `AgentExecutor` to prevent duplicate-argument `TypeError` ([#4298](https://github.com/microsoft/agent-framework/pull/4298))
• agent-framework-core: Preserve workflow run kwargs when continuing with `run(responses=...)` ([#4296](https://github.com/microsoft/agent-framework/pull/4296))
• agent-framework-core: Fix `WorkflowAgent` not persisting response messages to session history ([#4319](https://github.com/microsoft/agent-framework/pull/4319))
• agent-framework-core: Fix single-tool input handling in `OpenAIResponsesClient._prepare_tools_for_openai` ([#4312](https://github.com/microsoft/agent-framework/pull/4312))
• agent-framework-core: Fix agent option merge to support dict-defined tools ([#4314](https://github.com/microsoft/agent-framework/pull/4314))
• + 12 more

📋 What's Changed

• .NET: Support hosted code interpreter for skill script execution by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/4192
• .NET: AgentThread serialization alternatives ADR by @westey-m in https://github.com/microsoft/agent-framework/pull/3062
• .NET: Add helpers to more easily access in-memory ChatHistory and make ChatHistoryProvider management more configurable. by @westey-m in https://github.com/microsoft/agent-framework/pull/4224
• .Net: Add additional Hosted Agent Samples by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/4325
• .NET: Revert ".NET: Support hosted code interpreter for skill script execution" by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/4385
• .NET: Fixing issue with invalid node Ids when visualizing dotnet workflows. by @alliscode in https://github.com/microsoft/agent-framework/pull/4269
• .NET: Fix FileAgentSkillsProvider custom SkillsInstructionPrompt silently dropping skills by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/4388
• .NET: AuthN & AuthZ sample with asp.net service and web client by @westey-m in https://github.com/microsoft/agent-framework/pull/4354
• + 13 more

✨ Added

• agent-framework-core: Support Agent Skills ([#4210](https://github.com/microsoft/agent-framework/pull/4210))
• agent-framework-core: Add embedding abstractions and OpenAI implementation (Phase 1) ([#4153](https://github.com/microsoft/agent-framework/pull/4153))
• agent-framework-core: Add Foundry Memory Context Provider ([#3943](https://github.com/microsoft/agent-framework/pull/3943))
• agent-framework-core: Add `max_function_calls` to `FunctionInvocationConfiguration` ([#4175](https://github.com/microsoft/agent-framework/pull/4175))
• agent-framework-core: Add `CreateConversationExecutor`, fix input routing, remove unused handler layer ([#4159](https://github.com/microsoft/agent-framework/pull/4159))
• agent-framework-azure-ai-search: Azure AI Search provider improvements - EmbeddingGenerator, async context manager, KB message handling ([#4212](https://github.com/microsoft/agent-framework/pull/4212))
• agent-framework-azure-ai-search: Enhance Azure AI Search Citations with Document URLs in Foundry V2 ([#4028](https://github.com/microsoft/agent-framework/pull/4028))
• agent-framework-ag-ui: Add Workflow Support, Harden Streaming Semantics, and add Dynamic Handoff Demo ([#3911](https://github.com/microsoft/agent-framework/pull/3911))

📋 Changed

• agent-framework-declarative: [BREAKING] Add `InvokeFunctionTool` action for declarative workflows ([#3716](https://github.com/microsoft/agent-framework/pull/3716))

🐛 Fixed

• agent-framework-core: Fix thread corruption when `max_iterations` is reached ([#4234](https://github.com/microsoft/agent-framework/pull/4234))
• agent-framework-core: Fix workflow runner concurrent processing ([#4143](https://github.com/microsoft/agent-framework/pull/4143))
• agent-framework-core: Fix doubled `tool_call` arguments in `MESSAGES_SNAPSHOT` when streaming ([#4200](https://github.com/microsoft/agent-framework/pull/4200))
• agent-framework-core: Fix OpenAI chat client compatibility with third-party endpoints and OTel 0.4.14 ([#4161](https://github.com/microsoft/agent-framework/pull/4161))
• agent-framework-claude: Fix `structured_output` propagation in `ClaudeAgent` ([#4137](https://github.com/microsoft/agent-framework/pull/4137))

📋 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
• + 13 more

📦 [1.0.0rc1] - 2026-02-19

• Release candidate for agent-framework-core and agent-framework-azure-ai packages.

✨ Added

• agent-framework-core: Add default in-memory history provider for workflow agents ([#3918](https://github.com/microsoft/agent-framework/pull/3918))
• agent-framework-core: Durable support for workflows ([#3630](https://github.com/microsoft/agent-framework/pull/3630))

📋 Changed

• agent-framework-core: [BREAKING] Scope provider state by `source_id` and standardize source IDs ([#3995](https://github.com/microsoft/agent-framework/pull/3995))
• agent-framework-core: [BREAKING] Fix chat/agent message typing alignment ([#3920](https://github.com/microsoft/agent-framework/pull/3920))
• agent-framework-core: [BREAKING] Remove `FunctionTool[Any]` compatibility shim for schema passthrough ([#3907](https://github.com/microsoft/agent-framework/pull/3907))
• agent-framework-core: Inject OpenTelemetry trace context into MCP requests ([#3780](https://github.com/microsoft/agent-framework/pull/3780))
• agent-framework-core: Replace wildcard imports with explicit imports ([#3908](https://github.com/microsoft/agent-framework/pull/3908))

🐛 Fixed

• agent-framework-core: Fix hosted MCP tool approval flow for all session/streaming combinations ([#4054](https://github.com/microsoft/agent-framework/pull/4054))
• agent-framework-core: Prevent repeating instructions in continued Responses API conversations ([#3909](https://github.com/microsoft/agent-framework/pull/3909))
• agent-framework-core: Add missing system instruction attribute to `invoke_agent` span ([#4012](https://github.com/microsoft/agent-framework/pull/4012))
• agent-framework-core: Fix tool normalization and provider sample consolidation ([#3953](https://github.com/microsoft/agent-framework/pull/3953))
• agent-framework-azure-ai: Warn on unsupported AzureAIClient runtime tool/structured_output overrides ([#3919](https://github.com/microsoft/agent-framework/pull/3919))
• agent-framework-azure-ai-search: Improve Azure AI Search package test coverage ([#4019](https://github.com/microsoft/agent-framework/pull/4019))
• agent-framework-anthropic: Fix Anthropic option conflicts and manager parse retries ([#4000](https://github.com/microsoft/agent-framework/pull/4000))
• agent-framework-anthropic: Track and enforce 85%+ unit test coverage for anthropic package ([#3926](https://github.com/microsoft/agent-framework/pull/3926))
• + 2 more