From 3a18a5d76a6d12725f57335fd1ffd2148cfabe0b Mon Sep 17 00:00:00 2001 From: Rodrigo Brandao Date: Fri, 17 Jul 2026 10:57:25 -0700 Subject: [PATCH] Updating READMEs and changelog.md --- changelog.md | 55 +++++++++++++++++-- libraries/microsoft-agents-activity/readme.md | 18 ++++++ .../readme.md | 19 +++++++ .../readme.md | 18 ++++++ .../readme.md | 18 ++++++ .../readme.md | 18 ++++++ .../microsoft-agents-hosting-core/readme.md | 18 ++++++ .../readme.md | 9 +++ .../readme.md | 18 ++++++ .../readme.md | 18 ++++++ .../microsoft-agents-hosting-slack/readme.md | 9 +++ .../microsoft-agents-storage-blob/readme.md | 18 ++++++ .../microsoft-agents-storage-cosmos/readme.md | 18 ++++++ 13 files changed, 248 insertions(+), 6 deletions(-) diff --git a/changelog.md b/changelog.md index 1d0fb341..2d014517 100644 --- a/changelog.md +++ b/changelog.md @@ -1,3 +1,40 @@ +# Microsoft 365 Agents SDK for Python - Release Notes v1.2.0 + +**Release Date:** 2026-07-17 +**Previous Version:** 1.1.0 (Released 2026-06-19) + +This release adds first-class Microsoft Teams hosting APIs and a credential-free Entra ID authentication provider, while improving turn processing, OAuth token handling, streaming responses, and async runtime behavior. + +## Major Features & Enhancements + +- **Teams Hosting Package**: Added the new `microsoft-agents-hosting-msteams` package for building Teams agents with typed, decorator-based routing. It introduces `TeamsAgentExtension`, `TeamsTurnContext`, route namespaces for Teams invoke and event activities, and Teams API client access from handlers (#434) +- **Entra Auth Sidecar Package**: Added the new `microsoft-agents-authentication-entra-auth-sidecar` package for credential-free Entra ID Agent ID authentication through the Microsoft Entra ID Agent Container sidecar. It includes `SidecarAuth`, `SidecarHttpClient`, `SidecarConnectionSettings`, in-memory token caching, transient retry handling, and SSRF-safe sidecar URL validation (#424) +- **AgentApplication Lifecycle Hooks**: Added `before_turn` and `after_turn` hooks for app-level logic around route execution without requiring full middleware. Hooks can short-circuit processing, participate in state saving, and support scenarios such as app-level guards, telemetry enrichment, and turn cleanup (#431) +- **AgentApplication Routing and Connections**: Improved route registration and exposed `AgentApplication.connection_manager` for code that needs access to configured connections (#429, #432) +- **Detached SSO Token Exchange**: Teams SSO token exchange invoke activities are now handled independently from regular route dispatch, reducing duplicate route logic and making SSO callbacks more reliable (#469) + +## New Models & APIs + +- **StreamingResponse Attachments and Reset**: Added `StreamingResponse.add_attachment()` for final-message attachments and `StreamingResponse.reset()` for returning the helper to its initial state after a stream completes (#426) +- **Activity Method Type Handling**: Improved `Activity` helper methods for typed activity data and entity conversions, including support for the new `ActivityTreatment` entity type (#441) +- **Configuration Coercion Helpers**: Added shared boolean, integer, and float coercion helpers so environment-derived configuration values are interpreted consistently (#424) + +## Bug Fixes + +- **State Loading**: Removed duplicate `turn_state.load()` calls and corrected when state is loaded during `AgentApplication` initialization (#455, #460) +- **Middleware Pipeline**: Fixed `MiddlewareSet` registration and turn invocation so multiple middleware components are registered and invoked in order (#461) +- **Composite Channels**: Normalized composite channel IDs for all user token operations, improving OAuth behavior for Copilot Web and Teams channel IDs such as `msteams:copilot-web` (#457) +- **Teams Activity Hooks**: Fixed `TeamsActivityHandler` hook dispatch so Teams-specific handlers receive the required arguments (#450) +- **Concurrency**: Replaced runtime use of `threading.Lock` with `asyncio.Lock` in async execution paths to avoid blocking the event loop (#442) +- **Dependencies**: Removed the unused `azure-core` dependency from `microsoft-agents-hosting-core` (#467) + +## Developer Experience + +- **Logging**: Added color-coded log messages and simplified `ApplicationOptions` by removing the logger option in favor of standard module-level logging (#439, #443) +- **Samples and Documentation**: Fixed the FastAPI sample startup path and added missing dialogs package links to README release tables (#417, #458) + +--- + # Microsoft 365 Agents SDK for Python - Release Notes v1.1.0 **Release Date:** 2026-06-19 @@ -16,8 +53,6 @@ ## Developer Experience -- **Integration Testing**: Integration testing enhancements (#408) -- **Testing Initialization Helper**: New testing initialization helper (#416) - **Typing Annotations**: Updated typing annotations across the codebase (#418) --- @@ -25,12 +60,11 @@ # Microsoft 365 Agents SDK for Python - Release Notes v1.0.0 **Release Date:** May 22, 2026 -**Previous Version:** 0.9.0 (Released April 15, 2026) +**Previous Version:** 0.9.1 (Released May 4, 2026) ## Major Features & Enhancements - **Dialogs Library**: New `microsoft-agents-hosting-dialogs` package porting the BotFramework dialog system (WaterfallDialog, ComponentDialog, DialogSet, DialogContext) and prompts (TextPrompt, NumberPrompt, ChoicePrompt, ConfirmPrompt, DateTimePrompt, AttachmentPrompt, OAuthPrompt) to the new SDK (#378) -- **Teams SSO Consent**: Support for the Teams SSO `Consent Required` flow (#380) - **Teams Extension Updates**: `TeamsAgentExtension` and related types re-exported at the `microsoft_agents.hosting.teams` package root, integration with `microsoft-teams-api` 2.x Pydantic models, and new runnable samples for message extensions, task modules, and meeting events (#385) - **Copilot Web OAuth Base-Channel Support**: New optional `force_base_channel` parameter on `Activity.get_conversation_reference()` and `_OAuthFlow.begin_flow()` so OAuth token exchange uses the base channel (e.g. `msteams`) when receiving composite channel IDs like `msteams:copilot-web` (#392) - **Per-Channel Typing Indicator**: New `TypingChannelStrategy` and `TypingOptions` for configurable per-channel typing behavior, surfaced via `ApplicationOptions` and a streaming fix (#398) @@ -39,9 +73,18 @@ ## Developer Experience - **API Reference Docstrings**: Docstrings updated from short-form to fully qualified object names for Learn API reference generation (#381) + +--- + +# Microsoft 365 Agents SDK for Python - Release Notes v0.9.1 + +**Release Date:** 2026-05-04 +**Previous Version:** 0.9.0 (Released 2026-04-15) + +## Enhancements + +- **Teams SSO Consent**: Support for the Teams SSO `Consent Required` flow (#380) - **SuggestedActions Factory**: New factory for the `to` property of `SuggestedActions` (#370) -- **Dialogs Test Layout**: `hosting-dialogs` tests moved back under the top-level `tests/` directory for consistency with other packages (#379) -- **Build Dependencies**: Temporary fix for build testing dependencies (#404) --- diff --git a/libraries/microsoft-agents-activity/readme.md b/libraries/microsoft-agents-activity/readme.md index 2b7d3e77..fc7ccb30 100644 --- a/libraries/microsoft-agents-activity/readme.md +++ b/libraries/microsoft-agents-activity/readme.md @@ -15,6 +15,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe Date Release Notes + + 1.2.0 + 2026-07-17 + + + 1.2.0 Release Notes + + + 1.1.0 2026-06-19 @@ -33,6 +42,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe + + 0.9.1 + 2026-05-04 + + + 0.9.1 Release Notes + + + 0.9.0 2026-04-15 diff --git a/libraries/microsoft-agents-authentication-entra-auth-sidecar/readme.md b/libraries/microsoft-agents-authentication-entra-auth-sidecar/readme.md index b113baa0..b01260bf 100644 --- a/libraries/microsoft-agents-authentication-entra-auth-sidecar/readme.md +++ b/libraries/microsoft-agents-authentication-entra-auth-sidecar/readme.md @@ -7,6 +7,25 @@ Entra ID Agent Container** (the *sidecar*). Instead of acquiring tokens directly the SDK delegates token acquisition to the sidecar's HTTP API, so the agent process never handles secrets, certificates, or keys. +## Release Notes + + + + + + + + + + + + +
VersionDateRelease Notes
1.2.02026-07-17 + + 1.2.0 Release Notes + +
+ ## Why a sidecar? - **Credential-free agent code** — all credential management (Managed Identity, Workload diff --git a/libraries/microsoft-agents-authentication-msal/readme.md b/libraries/microsoft-agents-authentication-msal/readme.md index 76cfcc39..44087d89 100644 --- a/libraries/microsoft-agents-authentication-msal/readme.md +++ b/libraries/microsoft-agents-authentication-msal/readme.md @@ -15,6 +15,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe Date Release Notes + + 1.2.0 + 2026-07-17 + + + 1.2.0 Release Notes + + + 1.1.0 2026-06-19 @@ -33,6 +42,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe + + 0.9.1 + 2026-05-04 + + + 0.9.1 Release Notes + + + 0.9.0 2026-04-15 diff --git a/libraries/microsoft-agents-copilotstudio-client/readme.md b/libraries/microsoft-agents-copilotstudio-client/readme.md index e57d135c..ed014f81 100644 --- a/libraries/microsoft-agents-copilotstudio-client/readme.md +++ b/libraries/microsoft-agents-copilotstudio-client/readme.md @@ -16,6 +16,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe Date Release Notes + + 1.2.0 + 2026-07-17 + + + 1.2.0 Release Notes + + + 1.1.0 2026-06-19 @@ -34,6 +43,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe + + 0.9.1 + 2026-05-04 + + + 0.9.1 Release Notes + + + 0.9.0 2026-04-15 diff --git a/libraries/microsoft-agents-hosting-aiohttp/readme.md b/libraries/microsoft-agents-hosting-aiohttp/readme.md index e6a8e624..a882dc75 100644 --- a/libraries/microsoft-agents-hosting-aiohttp/readme.md +++ b/libraries/microsoft-agents-hosting-aiohttp/readme.md @@ -17,6 +17,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe Date Release Notes + + 1.2.0 + 2026-07-17 + + + 1.2.0 Release Notes + + + 1.1.0 2026-06-19 @@ -35,6 +44,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe + + 0.9.1 + 2026-05-04 + + + 0.9.1 Release Notes + + + 0.9.0 2026-04-15 diff --git a/libraries/microsoft-agents-hosting-core/readme.md b/libraries/microsoft-agents-hosting-core/readme.md index 3078b97d..04109423 100644 --- a/libraries/microsoft-agents-hosting-core/readme.md +++ b/libraries/microsoft-agents-hosting-core/readme.md @@ -16,6 +16,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe Date Release Notes + + 1.2.0 + 2026-07-17 + + + 1.2.0 Release Notes + + + 1.1.0 2026-06-19 @@ -34,6 +43,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe + + 0.9.1 + 2026-05-04 + + + 0.9.1 Release Notes + + + 0.9.0 2026-04-15 diff --git a/libraries/microsoft-agents-hosting-dialogs/readme.md b/libraries/microsoft-agents-hosting-dialogs/readme.md index 98630500..a84d4a39 100644 --- a/libraries/microsoft-agents-hosting-dialogs/readme.md +++ b/libraries/microsoft-agents-hosting-dialogs/readme.md @@ -64,6 +64,15 @@ dialogs.add(WaterfallDialog("main", [step1, step2])) Date Release Notes + + 1.2.0 + 2026-07-17 + + + 1.2.0 Release Notes + + + 1.1.0 2026-06-19 diff --git a/libraries/microsoft-agents-hosting-fastapi/readme.md b/libraries/microsoft-agents-hosting-fastapi/readme.md index 7de12b5d..0104ccee 100644 --- a/libraries/microsoft-agents-hosting-fastapi/readme.md +++ b/libraries/microsoft-agents-hosting-fastapi/readme.md @@ -9,6 +9,15 @@ This library provides FastAPI integration for Microsoft Agents, enabling you to Date Release Notes + + 1.2.0 + 2026-07-17 + + + 1.2.0 Release Notes + + + 1.1.0 2026-06-19 @@ -27,6 +36,15 @@ This library provides FastAPI integration for Microsoft Agents, enabling you to + + 0.9.1 + 2026-05-04 + + + 0.9.1 Release Notes + + + 0.9.0 2026-04-15 diff --git a/libraries/microsoft-agents-hosting-msteams/readme.md b/libraries/microsoft-agents-hosting-msteams/readme.md index f4b2dfb0..d02a2020 100644 --- a/libraries/microsoft-agents-hosting-msteams/readme.md +++ b/libraries/microsoft-agents-hosting-msteams/readme.md @@ -18,6 +18,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** — a compre Date Release Notes + + 1.2.0 + 2026-07-17 + + + 1.2.0 Release Notes + + + 1.1.0 2026-06-19 @@ -36,6 +45,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** — a compre + + 0.9.1 + 2026-05-04 + + + 0.9.1 Release Notes + + + 0.9.0 2026-04-15 diff --git a/libraries/microsoft-agents-hosting-slack/readme.md b/libraries/microsoft-agents-hosting-slack/readme.md index d514a393..7b225939 100644 --- a/libraries/microsoft-agents-hosting-slack/readme.md +++ b/libraries/microsoft-agents-hosting-slack/readme.md @@ -11,6 +11,15 @@ Integration library for building Slack agents using the Microsoft 365 Agents SDK Date Release Notes + + 1.2.0 + 2026-07-17 + + + 1.2.0 Release Notes + + + 1.1.0 2026-06-19 diff --git a/libraries/microsoft-agents-storage-blob/readme.md b/libraries/microsoft-agents-storage-blob/readme.md index 2dab87a8..f5721033 100644 --- a/libraries/microsoft-agents-storage-blob/readme.md +++ b/libraries/microsoft-agents-storage-blob/readme.md @@ -16,6 +16,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe Date Release Notes + + 1.2.0 + 2026-07-17 + + + 1.2.0 Release Notes + + + 1.1.0 2026-06-19 @@ -34,6 +43,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe + + 0.9.1 + 2026-05-04 + + + 0.9.1 Release Notes + + + 0.9.0 2026-04-15 diff --git a/libraries/microsoft-agents-storage-cosmos/readme.md b/libraries/microsoft-agents-storage-cosmos/readme.md index 0e59223c..17081716 100644 --- a/libraries/microsoft-agents-storage-cosmos/readme.md +++ b/libraries/microsoft-agents-storage-cosmos/readme.md @@ -16,6 +16,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe Date Release Notes + + 1.2.0 + 2026-07-17 + + + 1.2.0 Release Notes + + + 1.1.0 2026-06-19 @@ -34,6 +43,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe + + 0.9.1 + 2026-05-04 + + + 0.9.1 Release Notes + + + 0.9.0 2026-04-15