Skip to content

agent-framework

vdotnet-1.6.1 scope: dotnet Breaking

This release includes 1 breaking change for platform teams planning a safe upgrade.

Published 20d AI Agents & Assistants
✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

agent-framework agentic-ai agents ai .net multi-agent
+4 more
orchestration python sdk workflows

Affected surfaces

auth breaking_upgrade

ReleasePort's take

Moderate signal
editorial:auto 13d

The dotnet-1.6.1 release introduces a breaking change that auto-wires ChatClient with OpenTelemetryChatClient in OpenTelemetryAgent.

Why it matters: Update .NET applications to handle the new automatic wiring of ChatClient with OpenTelemetryChatClient before upgrading to dotnet-1.6.1.

Summary

AI summary

[Breaking Change] Auto-wire ChatClient with OpenTelemetryChatClient in OpenTelemetryAgent.

Changes in this release

Breaking Medium

Auto-wire ChatClient with OpenTelemetryChatClient in OpenTelemetryAgent (Breaking Change)

Auto-wire ChatClient with OpenTelemetryChatClient in OpenTelemetryAgent (Breaking Change)

Source: llm_adapter@2026-05-21

Confidence: low

 —
Breaking Medium

Tighten default access controls and CORS posture in DevUI (Python BREAKING)

Tighten default access controls and CORS posture in DevUI (Python BREAKING)

Source: llm_adapter@2026-05-21

Confidence: low

 —
Breaking Medium

Align file skill folder discovery with agentskills.io spec (Python BREAKING)

Align file skill folder discovery with agentskills.io spec (Python BREAKING)

Source: llm_adapter@2026-05-21

Confidence: low

 —
Feature Medium

Add IChatMessageInjector for message injection during function loop

Add IChatMessageInjector for message injection during function loop

Source: llm_adapter@2026-05-21

Confidence: high

 —
Feature Medium

Hosted-Files sample, AgentSessionFiles SDK companion, and integration test added

Hosted-Files sample, AgentSessionFiles SDK companion, and integration test added

Source: llm_adapter@2026-05-21

Confidence: high

 —
Feature Medium

DevUI adds configurable access controls for HTTP surface

DevUI adds configurable access controls for HTTP surface

Source: llm_adapter@2026-05-21

Confidence: high

 —
Feature Medium

Add A2A input-request content for human-in-the-loop scenarios

Add A2A input-request content for human-in-the-loop scenarios

Source: llm_adapter@2026-05-21

Confidence: high

 —
Feature Medium

Hosted Agents RAG Sample with Azure AI Search added

Hosted Agents RAG Sample with Azure AI Search added

Source: llm_adapter@2026-05-21

Confidence: high

 —
Feature Medium

Add dotnet shell tool (Feat/dotnet shell tool)

Add dotnet shell tool (Feat/dotnet shell tool)

Source: llm_adapter@2026-05-21

Confidence: high

 —
Feature Medium

Add harness agent package

Add harness agent package

Source: llm_adapter@2026-05-21

Confidence: high

 —
Feature Medium

Add ground_truth/expected_output support for workflow evaluation (evals)

Add ground_truth/expected_output support for workflow evaluation (evals)

Source: llm_adapter@2026-05-21

Confidence: high

 —
Feature Medium

Update FoundryAgent to address HostedAgents strict URL routing

Update FoundryAgent to address HostedAgents strict URL routing

Source: granite4.1:30b@2026-05-22-audit

Confidence: high

 —
Feature Medium

Filestore improvements

Filestore improvements

Source: llm_adapter@2026-05-21

Confidence: low

 —
Feature Medium

Declare Magnetic protocol messages

Declare Magnetic protocol messages

Source: llm_adapter@2026-05-21

Confidence: low

 —
Feature Low

Add hyperlight to release slnf

Add hyperlight to release slnf

Source: granite4.1:30b@2026-05-22-audit

Confidence: high

 —
Performance Medium

CI hardening — split Functions tests, re-enable skipped integration tests

CI hardening — split Functions tests, re-enable skipped integration tests

Source: llm_adapter@2026-05-21

Confidence: low

 —
Performance Low

Eliminate MSBuild parallel-output races in Foundry.Hosting IT

Eliminate MSBuild parallel-output races in Foundry.Hosting IT

Source: granite4.1:30b@2026-05-22-audit

Confidence: high

 —
Deprecation Medium

Remove Foundry Toolbox server-side tools support

Remove Foundry Toolbox server-side tools support

Source: llm_adapter@2026-05-21

Confidence: high

 —
Bugfix Medium

Fix service input persistence on stream error

Fix service input persistence on stream error

Source: llm_adapter@2026-05-21

Confidence: high

 —
Bugfix Medium

Synthesized Handoff FunctionResult no longer sent to agent

Synthesized Handoff FunctionResult no longer sent to agent

Source: llm_adapter@2026-05-21

Confidence: high

 —
Bugfix Medium

OpenAIResponsesAgentClient now includes agentName in endpoint path

OpenAIResponsesAgentClient now includes agentName in endpoint path

Source: llm_adapter@2026-05-21

Confidence: high

 —
Bugfix Medium

Fix FoundryToolboxMcp sample to use created toolbox

Fix FoundryToolboxMcp sample to use created toolbox

Source: granite4.1:30b@2026-05-22-audit

Confidence: high

 —
Bugfix Medium

Align Anthropic Extensions AI version

Align Anthropic Extensions AI version

Source: llm_adapter@2026-05-21

Confidence: low

 —
Bugfix Medium

Avoid mutating handoff message roles

Avoid mutating handoff message roles

Source: llm_adapter@2026-05-21

Confidence: low

 —
Bugfix Low

Fix build issue CA1873 in DevUI using LoggerMessage source generator

Fix build issue CA1873 in DevUI using LoggerMessage source generator

Source: granite4.1:30b@2026-05-22-audit

Confidence: high

 —
Refactor Medium

Simplify ClientHeadersScope to rely on AsyncLocal natural restoration

Simplify ClientHeadersScope to rely on AsyncLocal natural restoration

Source: llm_adapter@2026-05-21

Confidence: low

 —
Refactor Low

Refactor harness console rendering

Refactor harness console rendering

Source: granite4.1:30b@2026-05-22-audit

Confidence: high

 —
Full changelog

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
  • .NET: Remove Foundry Toolbox server-side tools support by @alliscode in https://github.com/microsoft/agent-framework/pull/5753
  • .NET: DevUI: add configurable access controls for the DevUI HTTP surface by @moonbox3 in https://github.com/microsoft/agent-framework/pull/5739
  • .NET: Add A2A input-request content for human-in-the-loop scenarios by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/5743
  • .NET fix: Synthesized Handoff FunctionResult is never sent to agent by @lokitoth in https://github.com/microsoft/agent-framework/pull/5718
  • .NET: Refactor harness console rendering by @westey-m in https://github.com/microsoft/agent-framework/pull/5751
  • .NET: fix: align Anthropic Extensions AI version by @danyalahmed1995 in https://github.com/microsoft/agent-framework/pull/5709
  • .NET: declare Magentic protocol messages by @he-yufeng in https://github.com/microsoft/agent-framework/pull/5778
  • .NET: Feat/dotnet shell tool by @alliscode in https://github.com/microsoft/agent-framework/pull/5604
  • .NET: Fix OpenAIResponsesAgentClient to include agentName in endpoint path by @giles17 in https://github.com/microsoft/agent-framework/pull/5748
  • .NET: CI hardening — split Functions tests, re-enable skipped integration tests by @giles17 in https://github.com/microsoft/agent-framework/pull/5717
  • .NET: Add harness agent package by @westey-m in https://github.com/microsoft/agent-framework/pull/5782
  • .NET: [Breaking Change] Auto-wire ChatClient with OpenTelemetryChatClient in OpenTelemetryAgent by @Copilot in https://github.com/microsoft/agent-framework/pull/5750
  • Dotnet: Fixing FoundryToolboxMcp sample to use created toolbox by @alliscode in https://github.com/microsoft/agent-framework/pull/5786
  • .NET: fix: avoid mutating handoff message roles by @he-yufeng in https://github.com/microsoft/agent-framework/pull/5808
  • .NET: feat(evals): add ground_truth/expected_output support for workflow evaluation by @alliscode in https://github.com/microsoft/agent-framework/pull/5755
  • .NET: Update version for release. by @alliscode in https://github.com/microsoft/agent-framework/pull/5789
  • .NET: Fix build issue CA1873 in DevUI by using LoggerMessage source generator by @alliscode in https://github.com/microsoft/agent-framework/pull/5831
  • [BREAKING] Python: DevUI: tighten default access controls and CORS posture by @moonbox3 in https://github.com/microsoft/agent-framework/pull/5740
  • [BREAKING] Python: Align file skill folder discovery with agentskills.io spec by @SergeyMenshykh in https://github.com/microsoft/agent-framework/pull/5807
  • .NET: Filestore improvements by @westey-m in https://github.com/microsoft/agent-framework/pull/5842
  • .NET: DevUI: quarantine flaky discovery integration test (#5845) by @rogerbarreto in https://github.com/microsoft/agent-framework/pull/5846
  • .NET: Update version to 1.6.1 for release by @westey-m in https://github.com/microsoft/agent-framework/pull/5843

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

Breaking Changes

  • [Breaking Change] Auto-wire ChatClient with OpenTelemetryChatClient in OpenTelemetryAgent.
View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track agent-framework

Get notified when new releases ship.

Sign up free

About agent-framework

A framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Python and .NET.

All releases →

Related context

Earlier breaking changes

  • vdotnet-1.9.0 Removes [Experimental] tag from .NET Orchestrations, marking them stable.
  • vpython-1.7.0 Remove Python-only declarative actions and rename alias kinds to C# canonical names in agent-framework-declarative.
  • vpython-1.6.0 Enable instrumentation by default in agent-framework-core and agent-framework-foundry.
  • vpython-1.4.0 Migrate to a2a-sdk v1.0 in agent-framework-a2a
  • vpython-1.4.0 Tighten default access controls and CORS posture in agent-framework-devui

Beta — feedback welcome: [email protected]