microsoft · Copilot · Dec 2, 2025 · Dec 2, 2025
@@ -1,3 +1,270 @@
+# Microsoft 365 Agents SDK for Python - Release Notes v0.6.0
+
+**Release Date:** November 18, 2025  
+**Previous Version:** 0.5.0 (Released October 22, 2025)
+
+## 🎉 What's New in 0.6.0
+
+This release focuses on expanding hosting options with FastAPI integration, introducing a comprehensive integration testing framework, enhancing error handling with distributed error resources and standardized error codes, and improving the developer experience with numerous bug fixes and quality improvements.
+
+---
+
+## 🚀 Major Features & Enhancements
+
+### FastAPI Integration Package
+A new hosting option for building Microsoft Agents using the FastAPI framework, providing an alternative to the existing AIOHTTP hosting.
+
+**New Capabilities:**
+- FastAPI-based hosting for Microsoft Agents
+- Streaming response functionality with chunked and interactive message delivery
+- Citation handling utilities for conversational AI scenarios
+- Support for Teams and Direct Line channels
+
+**Package:** `microsoft-agents-hosting-fastapi`
+
+**Pull Request:**
+- [#176 - FastAPI integration package](https://github.com/microsoft/Agents-for-python/pull/176)
+
+### Integration Testing Framework
+A comprehensive testing framework for agent integration testing, enabling automated testing of agent behaviors and conversations.
+
+**New Capabilities:**
+- Agent integration testing utilities
+- Authentication helpers and environment setup tools
+- Agent client classes for simulating conversations
+- Data-driven testing support
+- Benchmarking improvements with verbose output mode
+
+**Package:** `microsoft-agents-testing`
+
+**Pull Request:**
+- [#228 - Integration Testing Framework](https://github.com/microsoft/Agents-for-python/pull/228)
+
+### Distributed Error Resources with Error Codes
+Refactored error handling across the SDK to use distributed package-specific error resources with standardized error codes and help URLs.
+
+**Key Changes:**
+- Created `ErrorMessage` class for consistent error formatting
+- Distributed error resources across 8 packages with dedicated error code ranges
+- Each error includes: message template, error code, and help URL
+- Error codes use negative numbers aligned with C# SDK patterns
+
+**Error Code Ranges:**
+| Range | Package | Category |
+|-------|---------|----------|
+| -60000 to -60999 | microsoft-agents-authentication-msal | Authentication |
+| -61000 to -61999 | microsoft-agents-storage-cosmos | Storage (Cosmos) |
+| -61100 to -61199 | microsoft-agents-storage-blob | Storage (Blob) |
+| -62000 to -62999 | microsoft-agents-hosting-teams | Teams |
+| -63000 to -63999 | microsoft-agents-hosting-core | Hosting |
+| -64000 to -64999 | microsoft-agents-activity | Activity |
+| -65000 to -65999 | microsoft-agents-copilotstudio-client | Copilot Studio |
+| -66000 to -66999 | microsoft-agents-hosting-core | General/Validation |
+
+**Example Error Output:**
+```
+Failed to acquire token. {'error': 'invalid_grant'}
+
+Error Code: -60012
+Help URL: https://aka.ms/M365AgentsErrorCodes/#-60012
+```
+
+**Pull Requests:**
+- [#223 - Distribute error resources across packages with error codes and help URLs](https://github.com/microsoft/Agents-for-python/pull/223)
+- [#237 - Replace help_url_anchor with error_code in error message URLs](https://github.com/microsoft/Agents-for-python/pull/237)
+- [#240 - Move ErrorMessage to microsoft-agents-activity to resolve circular dependency](https://github.com/microsoft/Agents-for-python/pull/240)
+
+### TypingIndicator Simplification
+Refactored the `TypingIndicator` class for simpler usage and improved reliability.
+
+**Improvements:**
+- Simplified API with explicit `start()` and `stop()` methods
+- Removed asynchronous locking complexity
+- Typing indicator now scoped to a single conversation turn
+- Improved async task management with proper cancellation handling
+
+**Pull Request:**
+- [#212 - TypingIndicator simplification](https://github.com/microsoft/Agents-for-python/pull/212)
+
+### Proactive Messaging Sample
+New end-to-end sample demonstrating proactive messaging in Microsoft Teams.
+
+**Features:**
+- New agent implementation for proactive messaging
+- HTTP endpoints for creating conversations and sending proactive messages
+- Comprehensive documentation and setup instructions
+
+**Pull Requests:**
+- [#213 - Proactive sample](https://github.com/microsoft/Agents-for-python/pull/213)
+- [#217 - Fix for proactive experimental sample in WC](https://github.com/microsoft/Agents-for-python/pull/217)
+- [#218 - Fix for proactive experimental sample in WC](https://github.com/microsoft/Agents-for-python/pull/218)
+
+---
+
+## 🐛 Bug Fixes & Improvements
+
+### ChannelServiceAdapter.create_conversation Fix
+Fixed the connector client creation flow to properly initialize before the turn context, ensuring correct setup for conversation creation scenarios.
+
+**Changes:**
+- Refactored `create_connector_client` to accept optional `context` parameter
+- Updated error handling for claims identity validation
+- Added comprehensive unit tests for connector client factory logic
+
+**Pull Request:**
+- [#233 - Fix ChannelServiceAdapter.create_conversation implementation](https://github.com/microsoft/Agents-for-python/pull/233)
+
+### Streaming Response Improvements for Agentic Requests
+Disabled streaming when receiving agentic requests for the MS Teams channel to ensure compatibility.
+
+**Pull Request:**
+- [#243 - Disabling streaming when receiving agentic request for msteams channel](https://github.com/microsoft/Agents-for-python/pull/243)
+
+### Improved HTTP Client Error Handling
+Enhanced error handling and logging in `UserTokenClient` and `ConnectorClient` for more precise status code checking and consistent logging patterns.
+
+**Improvements:**
+- Updated status code checks to use precise ranges
+- Switched to parameterized logging for better performance
+- Improved handling for specific HTTP status codes (e.g., 404 responses)
+
+**Pull Request:**
+- [#202 - Improved UserTokenClient and ConnectorClient status code error handling](https://github.com/microsoft/Agents-for-python/pull/202)
+
+### Channel Detection for M365Copilot
+Updated streaming channel detection logic to support M365Copilot channel scenarios.
+
+**Pull Requests:**
+- [#208 - Channel check changes needed for M365Copilot](https://github.com/microsoft/Agents-for-python/pull/208)
+- [#210 - Cherry-pick 0.5 fixes for streaming and typing indicator](https://github.com/microsoft/Agents-for-python/pull/210)
+
+### Copilot Studio Client Improvements
+Updated the Copilot Studio client to properly capture and persist conversation IDs from HTTP response headers.
+
+**Pull Request:**
+- [#195 - Update conversation ID in copilot studio client when start_conversation is called](https://github.com/microsoft/Agents-for-python/pull/195)
+
+### Conversation ID Length Adjustment
+Reduced the default maximum conversation ID length from 200 to 150 characters to align with system constraints.
+
+**Pull Request:**
+- [#196 - Adjusting default max conversation id length](https://github.com/microsoft/Agents-for-python/pull/196)
+
+### Internal Logging Utility
+Added `_DeferredString` utility class for deferred string evaluation, improving logging efficiency for expensive string operations.
+
+**Pull Request:**
+- [#205 - Internal logging utility: _DeferredString](https://github.com/microsoft/Agents-for-python/pull/205)
+
+### Typing Indicator Error Handling
+Improved error handling in the typing indicator loop with cleaner cancellation handling.
+
+**Pull Request:**
+- [#209 - Temporal fix for typing indicator](https://github.com/microsoft/Agents-for-python/pull/209)
+
+---
+
+## 📚 Documentation & Developer Experience
+
+### Updated Contributing Guidelines
+Added clarified contribution instructions in README.md, including specific steps for Microsoft internal developers.
+
+**Pull Request:**
+- [#234 - Update contributing guidelines in README.md](https://github.com/microsoft/Agents-for-python/pull/234)
+
+### Type Hints and Documentation Improvements
+Enhanced type annotations and documentation across multiple files for improved clarity and consistency.
+
+**Improvements:**
+- Updated optional type hints for model fields
+- Improved docstring formatting and references
+- Added precise return type annotations for async methods
+
+**Pull Requests:**
+- [#207 - Update parameter type hints and documentation across multiple files](https://github.com/microsoft/Agents-for-python/pull/207)
+- [#214 - Type annotation and documentation improvements](https://github.com/microsoft/Agents-for-python/pull/214)
+
+### CODEOWNERS Update
+Updated team ownership to use the unified agents-sdk team for streamlined code reviews.
+
+**Pull Request:**
+- [#199 - Update CODEOWNERS for unified team ownership](https://github.com/microsoft/Agents-for-python/pull/199)
+
+---
+
+## 📦 Package Information
+
+### Included Libraries
+
+This release includes the following 9 core libraries (FastAPI integration package added in 0.6.0):
+
+1. **microsoft-agents-activity** - Core activity models and handling
+2. **microsoft-agents-authentication-msal** - MSAL authentication integration
+3. **microsoft-agents-copilotstudio-client** - Copilot Studio client connectivity
+4. **microsoft-agents-hosting-aiohttp** - AIOHTTP-based agent hosting
+5. **microsoft-agents-hosting-core** - Core hosting functionality and abstractions
+6. **microsoft-agents-hosting-fastapi** - FastAPI-based agent hosting *(New in 0.6.0)*
+7. **microsoft-agents-hosting-teams** - Microsoft Teams-specific hosting
+8. **microsoft-agents-storage-blob** - Azure Blob Storage integration
+9. **microsoft-agents-storage-cosmos** - Azure Cosmos DB storage integration
+
+### Python Version Support
+
+- **Supported Versions:** Python 3.10, 3.11, 3.12, 3.13, 3.14
+- **Minimum Required:** Python 3.10
+- **Recommended:** Python 3.11 or later for optimal performance
+
+---
+
+## 🚀 Getting Started
+
+### Installation
+
+Install individual packages as needed:
+
+```bash
+pip install microsoft-agents-activity
+pip install microsoft-agents-hosting-core
+pip install microsoft-agents-hosting-aiohttp
+pip install microsoft-agents-hosting-fastapi  # New in 0.6.0
+# ... other packages as needed
+```
+
+### Quick Start with FastAPI
+
+```python
+from microsoft_agents.hosting.fastapi import start_agent_process
+from microsoft_agents.hosting.core import TurnContext
+
+# Your FastAPI agent implementation here
+```
+
+### Sample Applications
+
+Explore comprehensive samples and documentation at:
+- [Microsoft 365 Agents SDK Samples](https://github.com/microsoft/Agents)
+- [Python-specific examples](https://github.com/microsoft/Agents-for-python/tree/main/test_samples)
+
+---
+
+## 🙏 Acknowledgments
+
+Special thanks to all contributors who made this release possible, including the Microsoft 365 Agents team and the open source community for their valuable feedback and contributions.
+
+---
+
+## 📞 Support & Resources
+
+- **Documentation:** [Microsoft 365 Agents SDK](https://aka.ms/agents)
+- **Issues:** [GitHub Issues](https://github.com/microsoft/Agents-for-python/issues)
+- **Samples:** [Agent Samples Repository](https://github.com/microsoft/Agents)
+- **Community:** Join our developer community discussions
+
+For technical support and questions, please use the GitHub Issues page or refer to our comprehensive documentation and samples.
+
+---
+---
+
 # Microsoft 365 Agents SDK for Python - Release Notes v0.5.0
 
 **Release Date:** October 22, 2025