microsoft-agents-hosting-core 1.2.0.dev20__tar.gz → 1.4.0.dev13__tar.gz

{microsoft_agents_hosting_core-1.2.0.dev20/microsoft_agents_hosting_core.egg-info → microsoft_agents_hosting_core-1.4.0.dev13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-hosting-core
-Version: 1.2.0.dev20
+Version: 1.4.0.dev13
 Summary: Core library for Microsoft Agents
 Author: Microsoft Corporation
 License-Expression: MIT
@@ -15,10 +15,9 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: microsoft-agents-activity==1.2.0.dev20
+Requires-Dist: microsoft-agents-activity==1.4.0.dev13
 Requires-Dist: pyjwt>=2.10.1
 Requires-Dist: isodate>=0.6.1
-Requires-Dist: azure-core>=1.30.0
 Requires-Dist: python-dotenv>=1.1.1
 Requires-Dist: opentelemetry-api>=1.27.0
 Requires-Dist: opentelemetry-sdk>=1.27.0
@@ -43,6 +42,24 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe
     <th style="width:20%">Date</th>
     <th style="width:60%">Release Notes</th>
   </tr>
+  <tr>
+    <td>1.3.0</td>
+    <td>2026-07-30</td>
+    <td>
+      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v130">
+        1.3.0 Release Notes
+      </a>
+    </td>
+  </tr>
+  <tr>
+    <td>1.2.0</td>
+    <td>2026-07-17</td>
+    <td>
+      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v120">
+        1.2.0 Release Notes
+      </a>
+    </td>
+  </tr>
   <tr>
     <td>1.1.0</td>
     <td>2026-06-19</td>
@@ -61,6 +78,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** - a comprehe
       </a>
     </td>
   </tr>
+  <tr>
+    <td>0.9.1</td>
+    <td>2026-05-04</td>
+    <td>
+      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v091">
+        0.9.1 Release Notes
+      </a>
+    </td>
+  </tr>
   <tr>
     <td>0.9.0</td>
     <td>2026-04-15</td>
@@ -126,11 +152,14 @@ We offer the following PyPI packages to create conversational experiences based
 | `microsoft-agents-activity` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-activity)](https://pypi.org/project/microsoft-agents-activity/) | Types and validators implementing the Activity protocol spec. |
 | `microsoft-agents-hosting-core` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-hosting-core)](https://pypi.org/project/microsoft-agents-hosting-core/) | Core library for Microsoft Agents hosting. |
 | `microsoft-agents-hosting-aiohttp` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-hosting-aiohttp)](https://pypi.org/project/microsoft-agents-hosting-aiohttp/) | Configures aiohttp to run the Agent. |
-| `microsoft-agents-hosting-teams` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-hosting-teams)](https://pypi.org/project/microsoft-agents-hosting-teams/) | Provides classes to host an Agent for Teams. |
+| `microsoft-agents-hosting-fastapi` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-hosting-fastapi)](https://pypi.org/project/microsoft-agents-hosting-fastapi/) | Configures fastapi to run the Agent. |
+| `microsoft-agents-hosting-msteams` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-hosting-msteams)](https://pypi.org/project/microsoft-agents-hosting-msteams/) | Provides classes to host an Agent for Teams. |
 | `microsoft-agents-hosting-dialogs` | [![PyPI](https://img.shields.io/pypi/v/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` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-hosting-slack)](https://pypi.org/project/microsoft-agents-hosting-slack/) | Provides classes to host an Agent for Slack. |
 | `microsoft-agents-storage-blob` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-storage-blob)](https://pypi.org/project/microsoft-agents-storage-blob/) | Extension to use Azure Blob as storage. |
 | `microsoft-agents-storage-cosmos` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-storage-cosmos)](https://pypi.org/project/microsoft-agents-storage-cosmos/) | Extension to use CosmosDB as storage. |
 | `microsoft-agents-authentication-msal` | [![PyPI](https://img.shields.io/pypi/v/microsoft-agents-authentication-msal)](https://pypi.org/project/microsoft-agents-authentication-msal/) | MSAL-based authentication for Microsoft Agents. |
+| `microsoft-agents-authentication-entra-auth-sidecar` | [![PyPI](https://img.shields.io/pypi/v/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:
 

microsoft_agents_hosting_core-1.4.0.dev13/VERSION.txt

@@ -0,0 +1 @@
+1.4.0.dev13

{microsoft_agents_hosting_core-1.2.0.dev20 → microsoft_agents_hosting_core-1.4.0.dev13}/microsoft_agents/hosting/core/__init__.py

@@ -15,9 +15,9 @@ from .http import (
     HttpRequestProtocol,
     HttpResponse,
     HttpResponseFactory,
-    HttpAdapterBase,
     ChannelServiceRoutes,
 )
+from ._http_adapter_base import HttpAdapterBase
 
 # Application Style
 from .app._type_defs import RouteHandler, RouteSelector, StateT
@@ -54,9 +54,10 @@ from .authorization.access_token_provider_base import AccessTokenProviderBase
 from .authorization.authentication_constants import AuthenticationConstants
 from .authorization.anonymous_token_provider import AnonymousTokenProvider
 from .authorization.connections import Connections
+from .authorization.connection_manager import ConnectionManager
 from .authorization.agent_auth_configuration import AgentAuthConfiguration
 from .authorization.claims_identity import ClaimsIdentity
-from .authorization.jwt_token_validator import JwtTokenValidator
+from .authorization.jwt.jwt_token_validator import JwtTokenValidator
 from .authorization.auth_types import AuthTypes
 
 # Client API
@@ -88,6 +89,13 @@ from .connector import (
     get_product_info,
 )
 
+# Header propagation
+from .header_propagation import (
+    HeaderValueProvider,
+    AgenticHeaderProvider,
+    HeaderPropagationContext,
+)
+
 # State management
 from .state.agent_state import AgentState
 from .state.state_property_accessor import StatePropertyAccessor
@@ -125,7 +133,7 @@ __all__ = [
     "InputFile",
     "InputFileDownloader",
     "Query",
-    "Route",
+    "_Route",
     "RouteHandler",
     "TypingIndicator",
     "Citation",
@@ -142,6 +150,7 @@ __all__ = [
     "AuthenticationConstants",
     "AnonymousTokenProvider",
     "Connections",
+    "ConnectionManager",
     "AgentAuthConfiguration",
     "ClaimsIdentity",
     "JwtTokenValidator",
@@ -166,6 +175,9 @@ __all__ = [
     "TeamsConnectorClient",
     "ConnectorClientBase",
     "get_product_info",
+    "HeaderValueProvider",
+    "AgenticHeaderProvider",
+    "HeaderPropagationContext",
     "AgentState",
     "StatePropertyAccessor",
     "UserState",

{microsoft_agents_hosting_core-1.2.0.dev20/microsoft_agents/hosting/core/http → microsoft_agents_hosting_core-1.4.0.dev13/microsoft_agents/hosting/core}/_http_adapter_base.py

@@ -4,22 +4,22 @@
 """Base HTTP adapter with shared processing logic."""
 
 from abc import ABC
+from http import HTTPStatus
 from traceback import format_exc
 
 from microsoft_agents.activity import Activity, DeliveryModes
-from microsoft_agents.hosting.core.authorization import ClaimsIdentity, Connections
-from microsoft_agents.hosting.core import (
-    Agent,
-    ChannelServiceAdapter,
-    ChannelServiceClientFactoryBase,
-    MessageFactory,
-    RestChannelServiceClientFactory,
-    TurnContext,
-)
 from microsoft_agents.hosting.core.telemetry.adapter import spans
 
-from ._http_request_protocol import HttpRequestProtocol
-from ._http_response import HttpResponse, HttpResponseFactory
+from .agent import Agent
+from .authorization.claims_identity import ClaimsIdentity
+from .authorization.connections import Connections
+from .channel_service_adapter import ChannelServiceAdapter
+from .channel_service_client_factory_base import ChannelServiceClientFactoryBase
+from .http._http_request_protocol import HttpRequestProtocol
+from .http._http_response import HttpResponse, HttpResponseFactory
+from .message_factory import MessageFactory
+from .rest_channel_service_client_factory import RestChannelServiceClientFactory
+from .turn_context import TurnContext
 
 
 class HttpAdapterBase(ChannelServiceAdapter, ABC):
@@ -34,12 +34,14 @@ class HttpAdapterBase(ChannelServiceAdapter, ABC):
         *,
         connection_manager: Connections | None = None,
         channel_service_client_factory: ChannelServiceClientFactoryBase | None = None,
+        channel_service_client_factory_options: dict | None = None,
     ):
         """Initialize the HTTP adapter.
 
-        Args:
-            connection_manager: Optional connection manager for OAuth.
-            channel_service_client_factory: Factory for creating channel service clients.
+        :param connection_manager: Optional connection manager for OAuth.
+        :param channel_service_client_factory: Factory for creating channel service clients.
+        :param channel_service_client_factory_options: Optional dictionary of options to pass to the channel service client factory
+            This is only used if channel_service_client_factory is not provided and connection_manager is provided.
         """
 
         async def on_turn_error(context: TurnContext, error: Exception):
@@ -58,12 +60,21 @@ class HttpAdapterBase(ChannelServiceAdapter, ABC):
 
         self.on_turn_error = on_turn_error
 
-        channel_service_client_factory = (
-            channel_service_client_factory
-            or RestChannelServiceClientFactory(connection_manager)
-        )
+        factory: ChannelServiceClientFactoryBase
 
-        super().__init__(channel_service_client_factory)
+        if channel_service_client_factory:
+            factory = channel_service_client_factory
+        else:
+            if not connection_manager:
+                raise ValueError(
+                    "HttpAdapterBase.__init__: Either channel_service_client_factory or connection_manager must be provided."
+                )
+            factory = RestChannelServiceClientFactory(
+                connection_manager,
+                **(channel_service_client_factory_options or {}),
+            )
+
+        super().__init__(factory)
 
     async def process_request(
         self, request: HttpRequestProtocol, agent: Agent
@@ -101,8 +112,10 @@ class HttpAdapterBase(ChannelServiceAdapter, ABC):
             span.share(activity=activity)
 
             # Get claims identity (default to anonymous if not set by middleware)
-            claims_identity: ClaimsIdentity = (
-                request.get_claims_identity() or ClaimsIdentity({}, False)
+            claims_identity: (
+                ClaimsIdentity
+            ) = request.get_claims_identity() or ClaimsIdentity(
+                {}, False, authentication_type="Anonymous"
             )
 
             # Validate required activity fields
@@ -128,8 +141,12 @@ class HttpAdapterBase(ChannelServiceAdapter, ABC):
                 ):
                     with spans.AdapterWriteResponse(activity):
                         # Invoke and ExpectReplies cannot be performed async
+                        invoke_response_status = (
+                            invoke_response.status if invoke_response else None
+                        )
                         return HttpResponseFactory.json(
-                            invoke_response.body, invoke_response.status
+                            invoke_response.body if invoke_response else None,
+                            invoke_response_status or HTTPStatus.NOT_IMPLEMENTED,
                         )
 
                 return HttpResponseFactory.accepted()

{microsoft_agents_hosting_core-1.2.0.dev20 → microsoft_agents_hosting_core-1.4.0.dev13}/microsoft_agents/hosting/core/_oauth/_oauth_flow.py

@@ -12,12 +12,12 @@ from typing import Optional
 from microsoft_agents.activity import (
     Activity,
     ActivityTypes,
-    TokenExchangeState,
+    TokenExchangeRequest,
     TokenResponse,
     SignInResource,
 )
 
-from ..connector.client import UserTokenClient
+from ..connector import UserTokenClientBase
 from ._flow_state import _FlowState, _FlowStateTag, _FlowErrorTag
 
 logger = logging.getLogger(__name__)
@@ -38,16 +38,10 @@ class _OAuthFlow:
 
     This class is responsible for managing the entire OAuth flow, including
     obtaining user tokens, signing out users, and handling token exchanges.
-
-    Contract with other classes (usage of other classes is enforced in unit tests):
-        TurnContext.activity.channel_id
-        TurnContext.activity.from_property.id
-
-        UserTokenClient: user_token.get_token(), user_token.sign_out()
     """
 
     def __init__(
-        self, flow_state: _FlowState, user_token_client: UserTokenClient, **kwargs
+        self, flow_state: _FlowState, user_token_client: UserTokenClientBase, **kwargs
     ):
         """
         Arguments:
@@ -125,13 +119,11 @@ class _OAuthFlow:
             self._user_id,
             self._abs_oauth_connection_name,
         )
-        token_response: TokenResponse = (
-            await self._user_token_client.user_token.get_token(
-                user_id=self._user_id,
-                connection_name=self._abs_oauth_connection_name,
-                channel_id=self._channel_id,
-                code=magic_code,
-            )
+        token_response: TokenResponse = await self._user_token_client.get_user_token(
+            user_id=self._user_id,
+            connection_name=self._abs_oauth_connection_name,
+            channel_id=self._channel_id,
+            magic_code=magic_code,
         )
         if token_response:
             logger.info("User token obtained successfully: %s", token_response)
@@ -153,7 +145,7 @@ class _OAuthFlow:
             self._user_id,
             self._abs_oauth_connection_name,
         )
-        await self._user_token_client.user_token.sign_out(
+        await self._user_token_client.sign_out_user(
             user_id=self._user_id,
             connection_name=self._abs_oauth_connection_name,
             channel_id=self._channel_id,
@@ -185,18 +177,9 @@ class _OAuthFlow:
 
         logger.debug("Starting new OAuth flow")
 
-        token_exchange_state = TokenExchangeState(
+        res = await self._user_token_client.get_token_or_sign_in_resource(
             connection_name=self._abs_oauth_connection_name,
-            conversation=activity.get_conversation_reference(force_base_channel=True),
-            relates_to=activity.relates_to,
-            ms_app_id=self._ms_app_id,
-        )
-
-        res = await self._user_token_client.user_token._get_token_or_sign_in_resource(
-            activity.from_property.id,
-            self._abs_oauth_connection_name,
-            token_exchange_state.conversation.channel_id,
-            token_exchange_state.get_encoded_state(),
+            activity=activity,
         )
 
         if res.token_response:
@@ -251,16 +234,18 @@ class _OAuthFlow:
         """Handles the continuation of the flow from an invoke activity for token exchange."""
         token_exchange_request = activity.value
         try:
-            token_response = await self._user_token_client.user_token.exchange_token(
+            token_response = await self._user_token_client.exchange_token(
                 user_id=self._user_id,
                 connection_name=self._abs_oauth_connection_name,
                 channel_id=self._channel_id,
-                body=token_exchange_request,
+                exchange_request=TokenExchangeRequest.model_validate(
+                    token_exchange_request
+                ),
             )
             return token_response, _FlowErrorTag.NONE
         except Exception as e:
             # A 400 with 'ConsentRequired' means the user hasn't consented yet.
-            # Return None so the caller can send a 412 back to Teams, which will
+            # Return TokenResponse() so the caller can send a 412 back to Teams, which will
             # prompt the user for consent and retry the token exchange.
             # Any other error is a critical failure and should propagate.
             if getattr(e, "status", None) == 400 and "Consent Required" in getattr(
@@ -271,7 +256,7 @@ class _OAuthFlow:
                     self._user_id,
                 )
 
-                return None, _FlowErrorTag.PRECONDITION_FAILED
+                return TokenResponse(), _FlowErrorTag.PRECONDITION_FAILED
             raise
 
     async def continue_flow(self, activity: Activity) -> _FlowResponse:

microsoft_agents_hosting_core-1.4.0.dev13/microsoft_agents/hosting/core/_utils/__init__.py

@@ -0,0 +1,6 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from ._service_set import _ServiceSet
+
+__all__ = ["_ServiceSet"]

microsoft_agents_hosting_core-1.4.0.dev13/microsoft_agents/hosting/core/_utils/_service_set.py

@@ -0,0 +1,55 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from __future__ import annotations
+
+from typing import TypeVar, cast, Any
+
+T = TypeVar("T")
+
+
+class _ServiceSet:
+    """
+    A class that represents a collection of services, allowing for the storage and retrieval of service instances by their type.
+    """
+
+    def __init__(self, service_set: _ServiceSet | None = None) -> None:
+        """
+        Initializes a new instance of the _ServiceSet class.
+
+        :param service_set: An optional _ServiceSet instance to copy the state from.
+        """
+        self._state: dict[type, Any] = {}
+        if service_set is not None:
+            self._state.update(service_set._state)
+
+    def get(self, key: type[T]) -> T | None:
+        """
+        Gets a value from the state collection.
+        :param key:
+        :return:
+        """
+        val = self._state.get(key)
+        if val is not None:
+            if not isinstance(val, key):
+                raise TypeError(
+                    f"Value for key '{key.__name__}' is not of type {key.__name__} (got {type(val).__name__})"
+                )
+            return cast(T, val)
+        return None
+
+    def has(self, key: type) -> bool:
+        """
+        Checks if a value exists in the state collection.
+        :param key: Type of the value to check for.
+        :return: True if the value exists, False otherwise.
+        """
+        return key in self._state
+
+    def set(self, key: type[T], value: T) -> None:
+        """
+        Sets a value in the state collection.
+        :param key: Type of the value to set.
+        :param value: The value to set.
+        """
+        self._state[key] = value

{microsoft_agents_hosting_core-1.2.0.dev20 → microsoft_agents_hosting_core-1.4.0.dev13}/microsoft_agents/hosting/core/app/_type_defs.py

@@ -13,3 +13,9 @@ StateT = TypeVar("StateT", bound=TurnState)
 
 class RouteHandler(Protocol[StateT]):
     def __call__(self, context: TurnContext, state: StateT, /) -> Awaitable[None]: ...
+
+
+class HandoffHandler(Protocol[StateT]):
+    def __call__(
+        self, context: TurnContext, state: StateT, handoff_data: str
+    ) -> Awaitable[None]: ...