This release includes 4 breaking changes for platform teams planning a safe upgrade.
Published 5d
AI Agents & Assistants
✓ No known CVEs patched
✓ 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
breaking_upgrade
auth
Summary
AI summary[BREAKING] Responses helpers now distinguish conversation IDs and TOOL_CALL events are emitted for workflow participant tool calls.
Full changelog
[1.12.0] - 2026-07-21
Added
- agent-framework-azure-cosmos-memory: Add an alpha Azure Cosmos DB semantic-memory context provider with fact extraction, user profiles, samples, and integration coverage (#6719)
- agent-framework-azurefunctions, agent-framework-core, agent-framework-durabletask: Add HITL response-URL addressing for requests raised from inside workflows (#7001)
- agent-framework-core: Add cross-session origin attribution to context-injected messages (#7041)
- agent-framework-core, agent-framework-tools: Warn when auto-approved tools have name collisions (#7090)
- agent-framework-core: Add a
session_provideroption toMCPSkillsSourceandMCPSkill(mutually exclusive withclient) that resolves the MCP session on every fetch, keeping cached skills reconnect-safe when the underlying session is replaced (#7135) - agent-framework-hosting-a2a: Add app-owned A2A hosting helpers (#7050)
- agent-framework-hosting-mcp: Add app-owned MCP hosting helpers for exposing agents and workflows as native MCP tools (#7209)
- agent-framework-hosting-responses: [BREAKING] Add Responses conversation ID creation and parsing helpers, and distinguish conversation IDs from previous response IDs (#7234)
- agent-framework-hosting-telegram: Add Telegram hosting helpers and samples (#7047)
- samples: Add a Microsoft OpenTelemetry Distro observability sample (#5632)
Changed
- agent-framework-ag-ui: [BREAKING] Emit
TOOL_CALLevents for workflow participant tool calls (#7039) - agent-framework-a2a: Reduce
A2AExecutorlog noise for content types without protocol mappings (#7034) - agent-framework-ag-ui, agent-framework-core: Optimize shared serialization paths (#7165)
- agent-framework-ag-ui, agent-framework-bedrock, agent-framework-claude, agent-framework-core, agent-framework-github-copilot, agent-framework-ollama, agent-framework-openai: Normalize chat finish reasons across providers (#7105)
- agent-framework-anthropic, agent-framework-azure-contentunderstanding, agent-framework-azure-cosmos, agent-framework-core, agent-framework-declarative, agent-framework-devui, agent-framework-foundry, agent-framework: Update Microsoft Foundry branding in shipped APIs and package documentation (#6999)
- agent-framework-azure-contentunderstanding, agent-framework-azure-cosmos-memory, agent-framework-chatkit, agent-framework-core, agent-framework-durabletask, agent-framework-foundry, agent-framework-foundry-hosting, agent-framework-gemini, agent-framework-hyperlight, agent-framework-lab, agent-framework-monty, agent-framework-openai, agent-framework-tools, agent-framework: Consolidate dependency updates and compatibility adjustments (#7204)
- agent-framework-azurefunctions, agent-framework-devui, agent-framework-foundry, agent-framework-hosting-responses, agent-framework-lab, agent-framework-mistral, agent-framework: Clean up dependency groups and compatibility handling (#7046)
- agent-framework-azurefunctions, agent-framework-durabletask: Normalize initial durable workflow inputs across hosting paths (#7205)
- agent-framework-core: [BREAKING — experimental] Correct harness before-strategy compaction when state persists per service call (#7055)
- agent-framework-core: [BREAKING] Graduate
create_harness_agentfrom experimental to stable (#7120) - agent-framework-core: Graduate the mode and todo providers from experimental to stable (#7053)
- agent-framework-core: Graduate
ToolApprovalMiddlewarefrom experimental to stable (#7106) - agent-framework-core: Graduate
FileMemoryProviderfrom experimental to stable (#7113) - agent-framework-core: Make
FileAccessProvideropt-in for harness agents (#7094) - agent-framework-core: Serialize tool definitions best-effort for observability (#7029)
- agent-framework-declarative: Promote declarative workflows from release candidate to stable (#7065)
- agent-framework-devui: Refine request logging (#7083)
- agent-framework-foundry-hosting: Promote the package to beta and add it to the main installation surface; make the Foundry Toolbox MCP skills sample self-contained (#7099)
- agent-framework-azure-contentunderstanding, agent-framework-gemini, agent-framework-mistral, agent-framework-monty, agent-framework-tools: Promote the packages to beta, add them to the main installation surface, expose lazy-loading namespaces, and move package-local samples into the root sample tree
- agent-framework-github-copilot: Forward
GitHubCopilotOptionsverbatim when creating sessions (#7155) - docs: Add self-hosting sample snippets (#7104)
- docs: Add environment-file templates for Durable Task hosting samples (#5948)
- samples: Keep ChatKit attachments close to the sample application that owns them (#7038)
Fixed
- agent-framework-ag-ui: Bind streamed tool arguments to their call ids (#6342)
- agent-framework-ag-ui: Accept state data URIs whose media type includes parameters (#6905)
- agent-framework-ag-ui: Coalesce reasoning deltas without content ids into a single reasoning block (#6804)
- agent-framework-ag-ui: Bridge request state and session continuity (#7084)
- agent-framework-ag-ui: Replay workflow handoff results correctly (#7102)
- agent-framework-ag-ui: Clarify
require_confirmationdocumentation forconfirm_changesHITL gating (#6884) - agent-framework-anthropic: Prevent per-run
additional_beta_flagsfrom leaking into request keyword arguments (#7060) - agent-framework-core: Clear
service_session_idin the agent wrapper when session propagation is enabled (#5875) - agent-framework-core: Preserve tool span context for parallel calls (#6512)
- agent-framework-core: Parse structured values assembled from split text chunks (#6990)
- agent-framework-core: Raise
ValueErrorfor malformed data URIs (#6916) - agent-framework-core: Preserve function-call names when merging streaming deltas (#6809)
- agent-framework-core, agent-framework-durabletask: Handle checkpoint encodings consistently (#6579)
- agent-framework-core: Preserve explicit null arguments during automatic function calling (#7108)
- agent-framework-core: Count non-ASCII text correctly during compaction (#7124)
- agent-framework-core: Forward
header_providerheaders to streamable HTTP MCP transports (#7218) - agent-framework-core: Prevent compaction from emitting empty projections (#7219)
- agent-framework-core: Return MCP tool-use sampling results to the requesting server (#7189)
- agent-framework-foundry-hosting: Make
FoundryToolbox.as_skills_provider()cache toolbox skill discovery by default soskill://index.jsonis read once instead of on every agent run, givedisable_cachingan observable effect, and add acache_refresh_intervaloption (#7135) - agent-framework-hosting, agent-framework-hosting-responses: Isolate stored session snapshots from later mutations (#7141)
- agent-framework-ollama: Generate distinct call ids for parallel tool calls (#6822)
- agent-framework-orchestrations: Prevent the Magentic manager from duplicating conversation history (#6297)
- samples: Correct the concurrent agents sample's handling of workflow output (#6548)
Breaking Changes
- [BREAKING] Add Responses conversation ID creation and parsing helpers, and distinguish conversation IDs from previous response IDs
- [BREAKING] Emit `TOOL_CALL` events for workflow participant tool calls
- [BREAKING — experimental] Correct harness before-strategy compaction when state persists per service call
- [BREAKING] Graduate `create_harness_agent` from experimental to stable
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
About agent-framework
A framework for building, orchestrating and deploying AI agents and multi-agent workflows with support for Python and .NET.
Related context
Related tools
Earlier breaking changes
- vpython-1.8.0 [BREAKING — experimental] Refactor Skill API to async resource and script lookup
- vpython-1.8.0 [BREAKING] Upgrade github-copilot-sdk to v1.0.0 (stable)
- 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.
Beta — feedback welcome: [email protected]