diff --git a/README.md b/README.md
index d3370427..8a3d629f 100644
--- a/README.md
+++ b/README.md
@@ -13,41 +13,6 @@ For more information please see the parent project information here [Microsoft 3
The best way to get started with these packages is to look at the samples available in [https://github.com/microsoft/Agents](https://github.com/microsoft/Agents)
-## Important Notice - Import Changes
-
-> **⚠️ Breaking Change**: Recent updates have changed the Python import structure from `microsoft.agents` to `microsoft_agents` (using underscores instead of dots). Please update your imports accordingly.
-
-### Import Examples
-
-```python
-# Activity types and models
-from microsoft_agents.activity import Activity
-
-# Core hosting functionality
-from microsoft_agents.hosting.core import TurnContext
-
-# aiohttp hosting
-from microsoft_agents.hosting.aiohttp import start_agent_process
-
-# FastAPI hosting
-from microsoft_agents.hosting.fastapi import start_agent_process
-
-# Teams-specific functionality (compatible only with activity handler)
-from microsoft_agents.hosting.teams import TeamsActivityHandler
-
-# Azure Blob storage
-from microsoft_agents.storage.blob import BlobStorage
-
-# CosmosDB storage
-from microsoft_agents.storage.cosmos import CosmosDbStorage
-
-# MSAL authentication
-from microsoft_agents.authentication.msal import MsalAuth
-
-# Copilot Studio client
-from microsoft_agents.copilotstudio.client import CopilotClient
-```
-
## Packages Overview
We offer the following PyPI packages to create conversational experiences based on Agents:
@@ -58,7 +23,7 @@ We offer the following PyPI packages to create conversational experiences based
| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. | `botbuilder-core, botframework-connector` |
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. | `botbuilder-integration-aiohttp` |
| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures FastAPI to run the Agent. | N/A |
-| `microsoft-agents-hosting-teams` | [](https://pypi.org/project/microsoft-agents-hosting-teams/) | Provides classes to host an Agent for Teams. | N/A |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. | N/A |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. | `botbuilder-dialogs` |
| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. | `botbuilder-azure` |
| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. | `botbuilder-azure` |
diff --git a/changelog.md b/changelog.md
index 2d014517..461d61ec 100644
--- a/changelog.md
+++ b/changelog.md
@@ -1,3 +1,50 @@
+# Microsoft 365 Agents SDK for Python - Release Notes v1.3.0
+
+**Release Date:** 2026-07-30
+**Previous Version:** 1.2.0 (Released 2026-07-17)
+
+This release focuses on API ergonomics and developer experience, adding agentic header propagation, fluent activity/card builders, type-based `TurnContext.services` , and app-based Graph client factories. It also refines authentication and storage interfaces, refactors JWT auth middleware, and includes broad typing, logging, and tooling improvements.
+
+> [!NOTE]
+> Use `microsoft-agents-hosting-msteams` for new Teams agents.
+> `microsoft-agents-hosting-msteams` is the current, first-class Teams hosting package. It provides typed, decorator-based routing via `TeamsAgentExtension` and `TeamsTurnContext`, dedicated route namespaces for Teams invoke and event activities, and direct access to Teams API clients from your handlers — the same modern, `AgentApplication`-centric programming model used across the rest of the SDK.
+> The older `microsoft-agents-hosting-teams` package (built around `TeamsActivityHandler` and `TeamsInfo`) is retained only for backward compatibility with existing agents. It is not receiving new features, and new development should migrate to `microsoft-agents-hosting-msteams`.
+
+> [!IMPORTANT]
+> `TurnContext.services` has been repurposed, and `TurnContext.has()`, `TurnContext.get()`, and `TurnContext.set()` have been removed to align with this change
+
+## Major Features & Enhancements
+
+- **Agentic Header Propagation**: Added a new `header_propagation` module with an agentic header provider that forwards headers on outbound requests, preserving request context across hops (#506)
+- **Fluent Activity Builders and Card Base Class**: Added fluent builders for constructing activities, a `Card` base class, and `AdaptiveCardCard` to make building rich activities and cards easier (#495)
+- **TurnContext Services**: Added `TurnContext.services` with generic, type-based keying and retrieval so handlers can register and resolve per-turn services without stringly-typed keys (#491)
+- **App-Based Graph Client Factories**: Added factory methods for app-based Graph clients in the Teams hosting library, with an accompanying `graph-clients` sample (#481)
+- **UserTokenClientBase Interface Expansion**: Expanded `UserTokenClientBase` to hide the need to access lower-level `UserToken` and `AgentSignIn` instances (#501)
+- **Token Provider From Activity**: Added `get_token_provider_from_activity` to `Connections` and `ConnectionManager` (#500)
+
+## New Models & APIs
+
+- **AccessTokenProviderBase Improvements**: Improved the `AccessTokenProviderBase` interface for clearer token acquisition (#494)
+- **Storage Provider Signatures**: Improved method signatures and typing annotations across storage providers (#498)
+- **ChannelServiceRoutes Handler Results**: Improved treatment of handler results in `ChannelServiceRoutes` (#462)
+- **Citation Icon Alignment**: Aligned `ClientCitationIconName` with the Teams "Add citations" documentation (#387)
+
+## Bug Fixes
+
+- **PowerPlatformEnvironment**: `PowerPlatformEnvironment.get_endpoint_suffix` now raises an exception on failure instead of returning it (#489)
+- **Linting**: Fixed linting issues in `hosting/core/app` (#488)
+
+## Developer Experience
+
+- **JWT Auth Middleware Refactor**: Refactored the JWT authorization middleware and added FastAPI JWT authorization middleware coverage (#497)
+- **Startup Logging**: Added startup configuration logging of connections and the connections map (#474)
+- **TurnContext Improvements**: TurnContext middleware improvements and annotation corrections, plus removal of the `_ChannelIdFieldMixin` (#487, #490)
+- **Hosting Request Adapter Deduplication**: Deduplicated hosting request adapter code across web framework integrations (#499)
+- **Typing and API Consistency**: Type annotations and API consistency tweaks throughout the codebase (#493)
+- **Tooling**: Updated the black version for pre-commit (#496)
+
+---
+
# Microsoft 365 Agents SDK for Python - Release Notes v1.2.0
**Release Date:** 2026-07-17
diff --git a/libraries/microsoft-agents-activity/readme.md b/libraries/microsoft-agents-activity/readme.md
index fc7ccb30..5b035068 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.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -116,11 +125,14 @@ We offer the following PyPI packages to create conversational experiences based
| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
-| `microsoft-agents-hosting-teams` | [](https://pypi.org/project/microsoft-agents-hosting-teams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
Additionally we provide a Copilot Studio Client, to interact with Agents created in CopilotStudio:
diff --git a/libraries/microsoft-agents-authentication-entra-auth-sidecar/readme.md b/libraries/microsoft-agents-authentication-entra-auth-sidecar/readme.md
index b01260bf..dcc8f50d 100644
--- a/libraries/microsoft-agents-authentication-entra-auth-sidecar/readme.md
+++ b/libraries/microsoft-agents-authentication-entra-auth-sidecar/readme.md
@@ -15,6 +15,15 @@ handles secrets, certificates, or keys.
Date |
Release Notes |
+
+ | 1.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -26,6 +35,24 @@ handles secrets, certificates, or keys.
+## Packages Overview
+
+We offer the following PyPI packages to create conversational experiences based on Agents:
+
+| Package Name | PyPI Version | Description |
+|--------------|-------------|-------------|
+| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
+| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
+| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
+| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
+| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
+| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
+
## 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 44087d89..caf881d5 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.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -116,11 +125,14 @@ We offer the following PyPI packages to create conversational experiences based
| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
-| `microsoft-agents-hosting-teams` | [](https://pypi.org/project/microsoft-agents-hosting-teams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
Additionally we provide a Copilot Studio Client, to interact with Agents created in CopilotStudio:
diff --git a/libraries/microsoft-agents-copilotstudio-client/readme.md b/libraries/microsoft-agents-copilotstudio-client/readme.md
index ed014f81..849be440 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.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -117,11 +126,14 @@ We offer the following PyPI packages to create conversational experiences based
| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
-| `microsoft-agents-hosting-teams` | [](https://pypi.org/project/microsoft-agents-hosting-teams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
Additionally we provide a Copilot Studio Client, to interact with Agents created in CopilotStudio:
diff --git a/libraries/microsoft-agents-hosting-aiohttp/readme.md b/libraries/microsoft-agents-hosting-aiohttp/readme.md
index a882dc75..b2040a66 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.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -118,11 +127,14 @@ We offer the following PyPI packages to create conversational experiences based
| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
-| `microsoft-agents-hosting-teams` | [](https://pypi.org/project/microsoft-agents-hosting-teams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
Additionally we provide a Copilot Studio Client, to interact with Agents created in CopilotStudio:
diff --git a/libraries/microsoft-agents-hosting-core/readme.md b/libraries/microsoft-agents-hosting-core/readme.md
index 04109423..7ec25c65 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.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -117,11 +126,14 @@ We offer the following PyPI packages to create conversational experiences based
| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
-| `microsoft-agents-hosting-teams` | [](https://pypi.org/project/microsoft-agents-hosting-teams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
Additionally we provide a Copilot Studio Client, to interact with Agents created in CopilotStudio:
diff --git a/libraries/microsoft-agents-hosting-dialogs/readme.md b/libraries/microsoft-agents-hosting-dialogs/readme.md
index a84d4a39..93dd106d 100644
--- a/libraries/microsoft-agents-hosting-dialogs/readme.md
+++ b/libraries/microsoft-agents-hosting-dialogs/readme.md
@@ -10,6 +10,70 @@ This library is a port of the botbuilder-dialogs library to the new Microsoft 36
This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehensive framework for building enterprise-grade conversational AI agents. The dialogs library enables developers to structure multi-turn conversations with reusable, composable dialog primitives.
+## Release Notes
+
+
+
+## Packages Overview
+
+We offer the following PyPI packages to create conversational experiences based on Agents:
+
+| Package Name | PyPI Version | Description |
+|--------------|-------------|-------------|
+| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
+| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
+| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
+| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
+| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
+| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
+
## Key Features
- **WaterfallDialog**: Sequential step-by-step conversation flows
@@ -56,39 +120,3 @@ dialogs.add(TextPrompt("text_prompt"))
dialogs.add(WaterfallDialog("main", [step1, step2]))
```
-## Release Notes
-
-
diff --git a/libraries/microsoft-agents-hosting-fastapi/readme.md b/libraries/microsoft-agents-hosting-fastapi/readme.md
index 0439b237..63885d0f 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.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -92,6 +101,24 @@ This library provides FastAPI integration for Microsoft Agents, enabling you to
+## Packages Overview
+
+We offer the following PyPI packages to create conversational experiences based on Agents:
+
+| Package Name | PyPI Version | Description |
+|--------------|-------------|-------------|
+| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
+| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
+| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
+| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
+| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
+| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
+
## Features
- FastAPI integration for Microsoft Agents
diff --git a/libraries/microsoft-agents-hosting-msteams/readme.md b/libraries/microsoft-agents-hosting-msteams/readme.md
index d02a2020..9492bd60 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.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -112,16 +121,21 @@ This library is part of the **Microsoft 365 Agents SDK for Python** — a compre
## Packages Overview
+We offer the following PyPI packages to create conversational experiences based on Agents:
+
| Package Name | PyPI Version | Description |
|--------------|-------------|-------------|
| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
Additionally we provide a Copilot Studio Client, to interact with Agents created in CopilotStudio:
@@ -465,6 +479,23 @@ async def on_profile(context: TeamsTurnContext, state):
The `handler_name` argument names an OAuth connection configured in the app's `auth` settings. If omitted, the app's default auth handler is used.
+`get_graph_client` returns a Graph client that acts **on behalf of the signed-in user**. When you need to call Graph with the **agent's own application identity** (application permissions, no user sign-in required), use the app-based clients instead:
+
+```python
+@teams.message(r"^report")
+async def on_report(context: TeamsTurnContext, state):
+ # Uses the app's default connection
+ graph = teams.get_app_graph_client(context)
+
+ # Or target a specific connection by name
+ graph = teams.get_app_graph_client_for_connection("MyGraphConnection")
+
+ users = await graph.users.get()
+ await context.send_activity(f"Tenant has {len(users.value)} users")
+```
+
+All three factory methods also accept an optional `graph_base_url` argument if you need to target a non-default Graph endpoint (for example a sovereign cloud).
+
## Invoke response conventions
Teams expects a synchronous HTTP response for all invoke activities. The routing layer handles this automatically — return a value from your handler and the framework serializes and sends it.
diff --git a/libraries/microsoft-agents-hosting-slack/readme.md b/libraries/microsoft-agents-hosting-slack/readme.md
index 7b225939..f6a32a08 100644
--- a/libraries/microsoft-agents-hosting-slack/readme.md
+++ b/libraries/microsoft-agents-hosting-slack/readme.md
@@ -4,13 +4,24 @@
Integration library for building Slack agents using the Microsoft 365 Agents SDK. Provides direct-to-Slack responses (the full Slack Web API surface, beyond what Azure Bot Service exposes), a typed `SlackChannelData` envelope with dot-notation property access, and a `SlackStream` helper for `chat.startStream` / `chat.appendStream` / `chat.stopStream`.
+
## Release Notes
+
| Version |
Date |
Release Notes |
+
+ | 1.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -31,6 +42,24 @@ Integration library for building Slack agents using the Microsoft 365 Agents SDK
+## Packages Overview
+
+We offer the following PyPI packages to create conversational experiences based on Agents:
+
+| Package Name | PyPI Version | Description |
+|--------------|-------------|-------------|
+| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
+| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
+| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
+| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
+| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
+| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
+
## Installation
```bash
diff --git a/libraries/microsoft-agents-hosting-teams/readme.md b/libraries/microsoft-agents-hosting-teams/readme.md
index ed43d444..f339d029 100644
--- a/libraries/microsoft-agents-hosting-teams/readme.md
+++ b/libraries/microsoft-agents-hosting-teams/readme.md
@@ -18,6 +18,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe
Date |
Release Notes |
+
+ | 1.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -110,11 +119,14 @@ We offer the following PyPI packages to create conversational experiences based
| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
-| `microsoft-agents-hosting-teams` | [](https://pypi.org/project/microsoft-agents-hosting-teams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
Additionally we provide a Copilot Studio Client, to interact with Agents created in CopilotStudio:
diff --git a/libraries/microsoft-agents-storage-blob/readme.md b/libraries/microsoft-agents-storage-blob/readme.md
index f5721033..a9169337 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.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -117,11 +126,14 @@ We offer the following PyPI packages to create conversational experiences based
| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
-| `microsoft-agents-hosting-teams` | [](https://pypi.org/project/microsoft-agents-hosting-teams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
Additionally we provide a Copilot Studio Client, to interact with Agents created in CopilotStudio:
diff --git a/libraries/microsoft-agents-storage-cosmos/readme.md b/libraries/microsoft-agents-storage-cosmos/readme.md
index 17081716..5743bd35 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.3.0 |
+ 2026-07-30 |
+
+
+ 1.3.0 Release Notes
+
+ |
+
| 1.2.0 |
2026-07-17 |
@@ -117,11 +126,14 @@ We offer the following PyPI packages to create conversational experiences based
| `microsoft-agents-activity` | [](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
| `microsoft-agents-hosting-core` | [](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
| `microsoft-agents-hosting-aiohttp` | [](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
-| `microsoft-agents-hosting-teams` | [](https://pypi.org/project/microsoft-agents-hosting-teams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-fastapi` | [](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
| `microsoft-agents-hosting-dialogs` | [](https://pypi.org/project/microsoft-agents-hosting-dialogs/) | Dialog system with waterfall dialogs, prompts, and multi-turn conversation management. |
+| `microsoft-agents-hosting-slack` | [](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
| `microsoft-agents-storage-blob` | [](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
| `microsoft-agents-storage-cosmos` | [](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
| `microsoft-agents-authentication-msal` | [](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [](https://pypi.org/project/microsoft-agents-authentication-entra-auth-sidecar/) | Credential-free Entra ID Agent ID authentication via the sidecar. |
Additionally we provide a Copilot Studio Client, to interact with Agents created in CopilotStudio: