microsoft/agent-framework python-1.24.0 on GitHub

1.24.0 - 2026-10-30

Warning

Redis context index migration: The beta RedisContextProvider now preserves exact scope identity and rejects the legacy raw-scope index schema. Delete the old context index and its context hashes, let the provider create a new index, and re-ingest the context data. overwrite_index=True does not migrate incompatible indexes.

Important

Python support: Python 3.11 or later is now the supported baseline, subject to package-specific upper limits. Python 3.10 installation remains permitted by Requires-Python in this release, but compatibility is not guaranteed. The next release will also remove Python 3.10 installation eligibility from Requires-Python. Upgrade to Python 3.11 or later as soon as possible.

Added

agent-framework-core: Add an explicit default approval mode for local MCP tools and prompts outside the per-tool approval lists, and warn when never_require_approval leaves the default implicit while preserving the existing fallback (#9828)
agent-framework-core: Add the shared microsoft.agent-framework telemetry resource attribute across logs, traces, and metrics while preserving explicit resource overrides (#9589)
agent-framework-core: Add experimental agent-triggered in-run compaction and skill unloading with AgentTriggeredCompactionStrategy and UnloadSkillsCompactionStrategy (#9384)
agent-framework-core: Support async conditions in switch-case workflow edge groups (#9669)
agent-framework-core: Load Agent Hooks middleware from a host declaration and support tool-name prefixes on FileAccessProvider (#9405, #9654)
agent-framework-core, agent-framework-anthropic, agent-framework-bedrock, agent-framework-foundry, agent-framework-foundry-local, agent-framework-gemini, agent-framework-mistral, agent-framework-ollama, agent-framework-openai: Add optional async chat-client contexts and ownership-aware connection cleanup without closing caller-supplied resources (#9748)
agent-framework-foundry: Add a timeout parameter to FoundryChatClient (#9699)
agent-framework-nvidia, agent-framework-openai: Add an alpha NVIDIA NIM embedding client and the OpenAI-compatible embedding request-options extension point it requires (#8920)

Changed

agent-framework-oracle: Require python-oracledb 3.0 or later so the supported dependency floor passes strict pool API type checking.
tests: Declare package-local test dependencies for isolated dependency-bound checks, match NVIDIA test transports to the OpenAI SDK's HTTPX version, preserve meaningful assertions across supported Pydantic and Foundry SDK versions, and exclude virtual environments from feature-registry source discovery.
agent-framework-claude: Require Claude Agent SDK 0.2.140 or later for custom-tool servers compatible with MCP 2.
agent-framework-azure-documentdb, agent-framework-mongodb: Require PyMongo 4.15 or later for complete asynchronous bulk-write type annotations at the supported dependency floor.
agent-framework-redis: [BREAKING] Preserve case-sensitive, punctuation-safe context scope identity with dedicated scope tokens, enforce configured scope on writes and searches, and reject incompatible legacy indexes (#9461)
agent-framework, agent-framework-a2a, agent-framework-ag-ui, agent-framework-anthropic, agent-framework-azure-ai-search, agent-framework-azure-contentunderstanding, agent-framework-azure-cosmos, agent-framework-azure-documentdb, agent-framework-bedrock, agent-framework-chatkit, agent-framework-claude, agent-framework-copilotstudio, agent-framework-core, agent-framework-declarative, agent-framework-devui, agent-framework-duckdb, agent-framework-foundry, agent-framework-foundry-hosting, agent-framework-foundry-local, agent-framework-gemini, agent-framework-hosting, agent-framework-hosting-a2a, agent-framework-hosting-mcp, agent-framework-hosting-responses, agent-framework-hosting-telegram, agent-framework-hyperlight, agent-framework-mem0, agent-framework-mistral, agent-framework-mongodb, agent-framework-monty, agent-framework-nvidia, agent-framework-ollama, agent-framework-openai, agent-framework-oracle, agent-framework-orchestrations, agent-framework-postgres, agent-framework-purview, agent-framework-qdrant, agent-framework-redis, agent-framework-sql-server, agent-framework-tools, agent-framework-typesafe: Stop advertising Python 3.10 support while retaining installation compatibility metadata, and document Python 3.11 as the supported baseline (#9824)
agent-framework-monty: Bound captured file counts and per-file and total byte sizes, and report omitted output explicitly (#9802)
agent-framework-tools: Apply shell output limits to standard error as well as standard output (#9795)
agent-framework-devui: Improve generated file display and URL handling (#9792)
agent-framework-devui: Update Zustand to 5.0.16 and ESLint to 10.13.0, pin TypeScript to the compatible 5.9.3 version, and rebuild the bundled UI (#9833, #9835)
agent-framework-nvidia: Allow Flit Core 4.x as a build backend (#9839)
tests, samples: Update Pyrefly to 1.4.0 with explicit provider option types, upgrade Griffe to 2.4.1 so attribute-value changes no longer produce API compatibility false positives, and refresh the standalone Lab lockfile to LiteLLM 1.106.2 (#9838, #9840, #9842, #9834, #9837)
agent-framework-azure-contentunderstanding: Align the Azure Content Understanding SDK dependency floor (#9695)
agent-framework, agent-framework-core: Advance the exact Core pin and standard-install dependency cohort to the versions in this release.
agent-framework-anthropic, agent-framework-azure-cosmos, agent-framework-bedrock, agent-framework-foundry, agent-framework-foundry-hosting, agent-framework-foundry-local, agent-framework-gemini, agent-framework-mistral, agent-framework-ollama, agent-framework-openai: Require Core 1.24 for inherited chat-client lifecycle methods, citation helpers, or checkpoint encoding; retain other Core floors under the strict API-usage policy.
agent-framework-foundry, agent-framework-foundry-local, agent-framework-nvidia: Require OpenAI 1.18 for owned-client cleanup or the new embedding request-options hook.
agent-framework-hosting-a2a, agent-framework-hosting-mcp, agent-framework-hosting-responses, agent-framework-hosting-telegram: Keep the exact shared hosting dependency pin aligned with its co-released version.
docs, samples: Refresh chat-client selectors and lifecycle guidance, compaction, harness file-memory configuration, skills environment setup, Foundry Toolbox tool search, Foundry memory settings, Redis context usage, ChatKit startup and weather widgets, migration examples, and sample run commands; add OpenViking, Membase, BotsRated, and ACGS community entries (#9673, #9748, #9384, #9670, #9700, #9113, #9741, #9446, #9579, #9599, #9580, #9641, #9683, #9660, #9618)
docs, tests: Refresh development setup, coding standards, sample guidance, and tooling helpers; validate dependency bounds for version bumps and new packages; prepare reviewed release manifests for the protected Azure DevOps publisher (#9733, #9637, #9706, #9668, #9801, #9821)

Fixed

agent-framework-core: Use the MCP transport's HTTPX 2 dependency to preserve HTTP span server attributes without requiring legacy HTTPX.
agent-framework-foundry-hosting: Declare the retry dependency required by Foundry Toolbox MCP subscription recovery.
agent-framework-core: Compare in-memory vector filters in the field's declared type, restoring native date, time, duration, Decimal, and UUID values and rejecting incompatible filter operands (#9574)
agent-framework-core: Reject metaclasses during restricted checkpoint reconstruction, including aliases and explicit allowlist entries, while preserving ordinary application-type round trips (#9825)
agent-framework-core: Preserve streamed workflow-agent usage, filter non-assistant workflow responses, finish in-flight checkpoint saves after sibling failures, resolve checkpoint timestamp ties through lineage, reject oversized MessagePack history records before writing, prevent in-memory file/directory collisions, and scope FIDES quarantine clients to their owning configuration (#9720, #8729, #9644, #9261, #9260, #9608, #9445)
agent-framework-core: Allow optional MCP task tools through plain calls, reject non-positive MCP request timeouts, and define the workflow edge type alias at module scope (#9746, #9314, #9614)
agent-framework-ag-ui, agent-framework-anthropic, agent-framework-core, agent-framework-foundry-hosting, agent-framework-openai: Preserve citations and distinguish source coordinates from generated-content offsets across providers, replay, and protocol adapters (#9436)
agent-framework-anthropic: Preserve server-tool continuation and replay, and honor allow_multiple_tool_calls when tool choice is unset (#9718, #8980)
agent-framework-azure-cosmos: Refuse checkpoints that cannot be restored under the configured type allowlist, and resolve latest-checkpoint timestamp ties through lineage (#8875, #9261)
agent-framework-claude: Send declared tool JSON schemas to Claude (#9302)
agent-framework-declarative: Honor registered function approval requirements even when an action omits or disables approval (#9606)
agent-framework-devui: Return client errors for unsupported conversation items (#9507)
agent-framework-foundry, agent-framework-openai: Merge both hosted MCP approval lists and wrap undecodable base64 embedding responses in a framework error (#9499, #9705)
agent-framework-foundry-hosting: Preserve generated image data, resolve checkpoint timestamp ties, and filter non-assistant workflow output (#9351, #9261, #8729)
agent-framework-gemini: Report the requested model on non-streaming responses (#9736)
agent-framework-github-copilot: Compose session hooks without dropping configured behavior (#9649)
agent-framework-openai: Preserve streamed Responses message identity and SSE error metadata, capture completed code-interpreter outputs, and reject misaligned base64 embedding payloads with descriptive errors (#9768, #9616, #9744, #9512)
agent-framework-orchestrations: Coerce Magentic round limits below one to one and correct HandoffBuilder output-selection documentation (#9502, #9717)
docs: Correct the Ollama embedding truncate default and make response-to-updates examples self-contained (#9672, #9437)