microsoft-agents-hosting-msteams 1.7.0.dev9__tar.gz → 1.8.0.dev0__tar.gz

{microsoft_agents_hosting_msteams-1.7.0.dev9/microsoft_agents_hosting_msteams.egg-info → microsoft_agents_hosting_msteams-1.8.0.dev0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-hosting-msteams
-Version: 1.7.0.dev9
+Version: 1.8.0.dev0
 Summary: Integration library for Microsoft Agents with Teams
 Author: Microsoft Corporation
 License-Expression: MIT
@@ -14,7 +14,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: microsoft-agents-hosting-core==1.7.0.dev9
+Requires-Dist: microsoft-agents-hosting-core==1.8.0.dev0
 Requires-Dist: aiohttp>=3.11.11
 Requires-Dist: microsoft-teams-api==2.1.0
 Requires-Dist: msgraph-sdk>=1.58.0
@@ -41,6 +41,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** — a compre
     <th style="width:20%">Date</th>
     <th style="width:60%">Release Notes</th>
   </tr>
+  <tr>
+    <td>1.8.0</td>
+    <td>2026-10-01</td>
+    <td>
+      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v180">
+        1.8.0 Release Notes
+      </a>
+    </td>
+  </tr>
   <tr>
     <td>1.7.0</td>
     <td>2026-09-17</td>
@@ -253,6 +262,10 @@ context.activity.notify_user(alert_in_meeting=True)
 
 # Attach a feedback loop to a message being sent (Copilot scenarios)
 context.activity.enable_feedback_loop()
+
+# Inspect quoted messages or targeted-message metadata
+quoted_messages = context.activity.get_quoted_messages()
+targeted_message = context.activity.get_targeted_message_info()
 ```
 
 #### `context.api_client` → `ApiClient`
@@ -261,13 +274,43 @@ Direct access to the Teams REST API client, pre-authenticated for the current tu
 
 #### Sending targeted activities
 
-`TeamsTurnContext` adds two methods for sending activities that target a specific user in a meeting:
+Use `TeamsTurnContext.send_targeted_activity()` to send a private activity to a
+specific user in a meeting or group conversation. Pass either the recipient ID
+or a `ChannelAccount`:
 
 ```python
-await context.send_targeted_activity(activity)
-await context.send_targeted_activities([activity1, activity2])
+await context.send_targeted_activity(
+    "Only you can see this message.",
+    recipient.id,
+)
 ```
 
+Replies to inbound targeted activities automatically include the prompt-preview
+metadata required by Teams.
+
+#### Sending quoted replies
+
+Use `TeamsActivity.add_quoted_reply()` to quote an existing message:
+
+```python
+from microsoft_agents.activity import ActivityTypes
+from microsoft_agents.hosting.msteams import TeamsActivity
+
+message_id = context.activity.id
+if not message_id:
+    raise ValueError("Message ID is required for a quoted reply.")
+
+reply = TeamsActivity(type=ActivityTypes.message)
+reply.add_quoted_reply(
+    message_id,
+    "This response includes a quote of your message.",
+)
+await context.send_activity(reply)
+```
+
+Use `context.activity.get_quoted_messages()` to inspect quoted messages on an
+incoming activity.
+
 ### Messaging Extensions
 
 ```python

microsoft_agents_hosting_msteams-1.8.0.dev0/VERSION.txt

@@ -0,0 +1 @@
+1.8.0.dev0

microsoft_agents_hosting_msteams-1.8.0.dev0/microsoft_agents/hosting/msteams/_teams_api_client.py

@@ -0,0 +1,132 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+"""Construction and caching of the Teams :class:`ApiClient` for a turn.
+
+The client is cached on turn context services so it is built at most once per turn, and
+is configured with a token factory derived from the turn's identity when one is
+available.
+"""
+
+import ssl
+import certifi
+
+from typing import Callable, Awaitable
+
+import httpx
+
+from microsoft_teams.common import Client, ClientOptions
+from microsoft_teams.api import ApiClient
+
+from microsoft_agents.hosting.core import (
+    Connections,
+    TurnContext,
+)
+
+_ssl_context: ssl.SSLContext | None = None
+
+
+def _get_ssl_context() -> ssl.SSLContext:
+    """Get or create the SSL context for verifying HTTPS requests.
+
+    httpx by default creates a new SSL context for each new client instance. This can be
+    inefficient. For example, at the time of writing this, without caching the SSL context,
+    the hosting_msteams unit tests took 32 seconds to complete. With caching, the total
+    time for the unit tests dropped to 7 seconds. For an agent with lots of traffic,
+    caching the SSL context may significantly improve performance and avoid extra io operations.
+    """
+    global _ssl_context
+
+    if _ssl_context is None:
+        _ssl_context = ssl.create_default_context(cafile=certifi.where())
+    return _ssl_context
+
+
+def _client(
+    base_url: str,
+    headers: dict,
+    token_factory: Callable[[], Awaitable[str]] | None = None,
+) -> Client:
+    """
+    Create a new Client instance configured with the given base URL, headers, and token factory.
+
+    :param base_url: The base URL for the client.
+    :param headers: The headers to include in the client requests.
+    :param token_factory: A callable that returns an access token asynchronously, or None if no token is required.
+    :return: A configured Client instance.
+    """
+
+    options = ClientOptions(
+        base_url=base_url,
+        headers=headers,
+        token=token_factory,
+    )
+
+    return Client(
+        options,
+        _http=httpx.AsyncClient(
+            base_url=base_url,
+            headers=headers,
+            timeout=options.timeout,
+            verify=_get_ssl_context(),
+        ),
+    )
+
+
+def _get_teams_api_client(context: TurnContext) -> ApiClient:
+    """
+    Get the cached Teams API client from the context.
+
+    :param context: The turn context.
+    :return: The cached Teams API client.
+    :raises ValueError: If the Teams API client is not found.
+    """
+    api_client = context.services.get(ApiClient)
+    if isinstance(api_client, ApiClient):
+        return api_client
+    raise ValueError("Unable to retrieve Teams API client.")
+
+
+def _set_teams_api_client(
+    context: TurnContext, connection_manager: Connections
+) -> None:
+    """
+    Set the Teams API client in the context if it is not already set.
+
+    :param context: The turn context.
+    :param connection_manager: The connection manager.
+    """
+
+    if context.services.has(ApiClient):
+        return
+
+    headers = {
+        "Accept": "application/json",
+        "Content-Type": "application/json",
+    }
+
+    token_factory: Callable[[], Awaitable[str]] | None = None
+
+    if context.identity:
+        provider = connection_manager.get_token_provider(
+            context.identity, context.activity.service_url
+        )
+
+        async def _token_factory() -> str:
+            return await provider.get_access_token(
+                "https://api.botframework.com",
+                ["https://api.botframework.com/.default"],
+            )
+
+        token_factory = _token_factory
+
+    api_client = ApiClient(
+        context.activity.service_url,
+        options=_client(
+            base_url=context.activity.service_url,
+            headers=headers,
+            token_factory=token_factory,
+        ),
+    )
+
+    context.services.set(ApiClient, api_client)

{microsoft_agents_hosting_msteams-1.7.0.dev9 → microsoft_agents_hosting_msteams-1.8.0.dev0}/microsoft_agents/hosting/msteams/_utils.py

@@ -14,10 +14,12 @@ from microsoft_teams.api.models.channel_data import ChannelData, ChannelInfo, Te
 from microsoft_agents.activity import (
     Activity,
     ActivityTypes,
+    Entity,
     InvokeResponse,
 )
 from microsoft_agents.hosting.core import TurnContext
 
+from .models import TargetedMessageInfo
 from .type_defs import CommandSelector
 
 
@@ -146,3 +148,41 @@ async def _send_invoke_response(context: TurnContext, body: Any = None) -> None:
             value=InvokeResponse(status=int(HTTPStatus.OK), body=serialized_body),
         )
     )
+
+
+def _apply_prompt_preview_normalizer(activity: Activity, message_id: str) -> None:
+    """Normalize the prompt preview for the given activity.
+
+    :param activity: The activity to normalize.
+    :param message_id: The message ID to associate with the targeted message info.
+    :return: None
+    """
+    pattern = re.compile(r"<quoted messageId=\"[^\"]*\"/>")
+    target_type = "quotedreply"
+    if activity.entities:
+
+        def _keep(entity: Entity) -> bool:
+            return entity.type.lower() != target_type
+
+        activity.entities[:] = [entity for entity in activity.entities if _keep(entity)]
+
+    if activity.text:
+        text_without_placeholder = pattern.sub("", activity.text)
+        if len(text_without_placeholder) != len(activity.text):
+            activity.text = text_without_placeholder.strip()
+
+    if not activity._get_entities_by_type("targetedmessageinfo"):
+        activity.entities = activity.entities or []
+        activity.entities.append(TargetedMessageInfo(message_id=message_id))
+
+
+def _is_recipient_targeted(activity: Activity) -> bool:
+    """Check if the recipient is targeted in the given activity.
+
+    :param activity: The activity to check.
+    :return: True if the recipient is targeted, False otherwise.
+    """
+    recipient = activity.recipient
+    if recipient is None:
+        return False
+    return recipient and getattr(recipient, "isTargeted", None) is True

microsoft_agents_hosting_msteams-1.8.0.dev0/microsoft_agents/hosting/msteams/models/__init__.py

@@ -0,0 +1,7 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from .quoted_reply import QuotedReply, QuotedReplyData
+from .targeted_message_info import TargetedMessageInfo
+
+__all__ = ["QuotedReply", "QuotedReplyData", "TargetedMessageInfo"]

microsoft_agents_hosting_msteams-1.8.0.dev0/microsoft_agents/hosting/msteams/models/quoted_reply.py

@@ -0,0 +1,24 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from typing import Literal
+from microsoft_agents.activity import AgentsModel, Entity
+
+
+class QuotedReplyData(AgentsModel):
+    """Represents a quoted reply in a Teams activity."""
+
+    message_id: str
+    sender_id: str | None = None
+    sender_name: str | None = None
+    preview: str | None = None
+    time: str | None = None
+    is_reply_deleted: bool | None = None
+    validated_message_reference: bool | None = None
+
+
+class QuotedReply(Entity):
+    """Contains the metadata for a quoted Teams message."""
+
+    type: Literal["quotedReply"] = "quotedReply"
+    quoted_reply: QuotedReplyData | None = None

microsoft_agents_hosting_msteams-1.8.0.dev0/microsoft_agents/hosting/msteams/models/targeted_message_info.py

@@ -0,0 +1,12 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+from typing import Literal
+from microsoft_agents.activity import Entity
+
+
+class TargetedMessageInfo(Entity):
+    """Identifies the inbound targeted message associated with a Prompt Preview response."""
+
+    type: Literal["targetedMessageInfo"] = "targetedMessageInfo"
+    message_id: str

{microsoft_agents_hosting_msteams-1.7.0.dev9 → microsoft_agents_hosting_msteams-1.8.0.dev0}/microsoft_agents/hosting/msteams/teams_activity.py

@@ -3,7 +3,10 @@
 
 """Teams-aware :class:`Activity` subclass exposing Teams channel data helpers."""
 
+import html
+
 from typing import Literal
+from typing_extensions import Self
 
 from microsoft_teams.api.models import (
     ChannelData,
@@ -15,7 +18,8 @@ from microsoft_teams.api.models import (
 
 from microsoft_agents.activity import Activity
 
-from ._utils import _try_get_channel_data
+from .models import QuotedReply, QuotedReplyData, TargetedMessageInfo
+from ._utils import _try_get_channel_data, _is_recipient_targeted
 
 
 class TeamsActivity(Activity):
@@ -121,3 +125,53 @@ class TeamsActivity(Activity):
             feedback_loop=FeedbackLoop(type=feedback_loop_type)
         )
         return True
+
+    def is_recipient_targeted(self) -> bool:
+        """Check if the recipient is targeted in the activity.
+
+        :return: True if the recipient is targeted, False otherwise.
+        """
+        return _is_recipient_targeted(self)
+
+    def get_targeted_message_info(self) -> TargetedMessageInfo | None:
+        """Get the targeted message information from the activity.
+
+        :return: The targeted message information if available, None otherwise.
+        """
+        res = self._get_entity_by_type("targetedMessageInfo")
+        if res:
+            return self._convert_entity(res, entity_cls=TargetedMessageInfo)
+        return None
+
+    def get_quoted_messages(self) -> list[QuotedReply]:
+        """Get the quoted messages from the activity.
+
+        :return: A list of quoted messages.
+        """
+        return self._convert_entity_list(
+            self._get_entities_by_type("quotedReply"), entity_cls=QuotedReply
+        )
+
+    def add_quoted_reply(self, message_id: str, text: str | None = None) -> Self:
+        """Add a quoted reply to the activity.
+
+        :param message_id: The ID of the message being quoted.
+        :param text: The text of the quoted reply.
+        :return: The updated activity instance.
+        """
+        self.entities = self.entities or []
+        self.entities.append(
+            QuotedReply(
+                type="quotedReply",
+                quoted_reply=QuotedReplyData(
+                    message_id=message_id,
+                ),
+            )
+        )
+
+        placeholder = f'<quoted messageId="{html.escape(message_id, quote=True)}"/>'
+        self.text = f"{self.text or ''}{placeholder}"
+        if text is not None:
+            self.text = f"{self.text} {text}"
+
+        return self

{microsoft_agents_hosting_msteams-1.7.0.dev9 → microsoft_agents_hosting_msteams-1.8.0.dev0}/microsoft_agents/hosting/msteams/teams_agent_extension.py

@@ -123,9 +123,17 @@ class TeamsAgentExtension(Generic[StateT]):
     def _configure_app(self):
         """Configure the underlying AgentApplication with Teams-specific routes."""
 
+        async def on_close_turn(context: TurnContext) -> None:
+            if context.activity.channel_id == Channels.ms_teams:
+                api_client = context.services.get(ApiClient)
+                if api_client is not None:
+                    await api_client.http.http.aclose()
+
         async def on_before_turn(context: TurnContext, state: StateT) -> bool:
             if context.activity.channel_id == Channels.ms_teams:
                 _set_teams_api_client(context, self._app.connection_manager)
+                context._on_aclose(on_close_turn)
+
                 # caches the deserialized version of ChannelData
                 context.activity.channel_data = _try_get_channel_data(context.activity)
             return True

{microsoft_agents_hosting_msteams-1.7.0.dev9 → microsoft_agents_hosting_msteams-1.8.0.dev0}/microsoft_agents/hosting/msteams/teams_turn_context.py

@@ -5,6 +5,7 @@
 
 from __future__ import annotations
 
+import warnings
 from typing import cast
 
 from msgraph import GraphServiceClient
@@ -13,8 +14,9 @@ from microsoft_teams.api import ApiClient
 
 from microsoft_agents.activity import (
     Activity,
-    ActivityTreatment,
-    ActivityTreatmentTypes,
+    ActivityTypes,
+    ChannelAccount,
+    InputHints,
     ResourceResponse,
 )
 from microsoft_agents.hosting.core import (
@@ -30,6 +32,7 @@ from ._graph import (
 )
 from ._teams_api_client import _get_teams_api_client, _set_teams_api_client
 from .teams_activity import TeamsActivity
+from ._utils import _apply_prompt_preview_normalizer, _is_recipient_targeted
 
 
 class TeamsTurnContext(TurnContext):
@@ -98,42 +101,92 @@ class TeamsTurnContext(TurnContext):
         """Get the API client for the Teams turn context."""
         return _get_teams_api_client(self)
 
-    @staticmethod
-    def _make_targeted_activity(activity: Activity) -> None:
+    def _apply_prompt_preview(self, activity: Activity) -> None:
         """
-        Make an activity targeted.
+        Apply the prompt preview to the given activity.
 
-        :param activity: The activity to make targeted.
+        :param activity: The activity to apply the prompt preview to.
         :return: None
         """
-        activity.entities = activity.entities or []
-        activity.entities.append(
-            ActivityTreatment(treatment=ActivityTreatmentTypes.TARGETED)
+        if (
+            activity.type == ActivityTypes.message
+            and _is_recipient_targeted(self.activity)
+            and self.activity.id
+        ):
+            _apply_prompt_preview_normalizer(activity, self.activity.id)
+
+    async def send_activity(
+        self,
+        activity_or_text: Activity | str,
+        speak: str | None = None,
+        input_hint: str | None = None,
+    ) -> ResourceResponse:
+        """Send an activity after applying the prompt preview.
+
+        :param activity_or_text: The activity or text to send.
+        :param speak: Optional speech text for the activity.
+        :param input_hint: Optional input hint for the activity.
+        :return: The resource response for the sent activity.
+        """
+
+        if isinstance(activity_or_text, str):
+            activity_or_text = Activity(
+                type=ActivityTypes.message,
+                text=activity_or_text,
+                input_hint=input_hint or InputHints.accepting_input,
+            )
+            if speak:
+                activity_or_text.speak = speak
+
+        self._apply_prompt_preview(activity_or_text)
+        return await TurnContext.send_activity(self._original, activity_or_text)
+
+    async def send_activities(
+        self, activities: list[Activity]
+    ) -> list[ResourceResponse]:
+        """Send multiple activities after applying the prompt preview to each.
+
+        :param activities: A list of activities to send.
+        :return: A list of resource responses for the sent activities.
+        """
+
+        for activity in activities:
+            self._apply_prompt_preview(activity)
+
+        return await TurnContext.send_activities(
+            self._original,
+            activities,
         )
 
-    async def send_targeted_activity(self, activity: Activity) -> ResourceResponse:
+    async def send_targeted_activity(
+        self,
+        activity: str | Activity,
+        recipient: str | ChannelAccount | None = None,
+    ) -> ResourceResponse:
         """
         Send a targeted activity.
 
         :param activity: The activity to send.
+        :param recipient: The recipient to target the activity to. Can be a string or a ChannelAccount instance.
         :return: The resource response.
         """
-        TeamsTurnContext._make_targeted_activity(activity)
+        if recipient is None:
+            warnings.warn(
+                "Using an empty recipient is deprecated and will be removed in a future release.",
+                DeprecationWarning,
+                stacklevel=2,
+            )
+            if isinstance(activity, str) or not activity.recipient:
+                raise ValueError(
+                    "Cannot infer the recipient from the passed-in activity."
+                )
+            recipient = activity.recipient
+
+        if isinstance(activity, str):
+            activity = Activity(type=ActivityTypes.message, text=activity)
+        activity.with_targeted_recipient(recipient)
         return await self.send_activity(activity)
 
-    async def send_targeted_activities(
-        self, activities: list[Activity]
-    ) -> list[ResourceResponse]:
-        """
-        Send a list of targeted activities.
-
-        :param activities: The list of activities to send.
-        :return: A list of resource responses.
-        """
-        for activity in activities:
-            TeamsTurnContext._make_targeted_activity(activity)
-        return await self.send_activities(activities)
-
     def get_graph_client(
         self,
         handler_name: str | None = None,

microsoft_agents_hosting_msteams-1.7.0.dev9/readme.md → microsoft_agents_hosting_msteams-1.8.0.dev0/microsoft_agents_hosting_msteams.egg-info/PKG-INFO

@@ -1,3 +1,26 @@
+Metadata-Version: 2.4
+Name: microsoft-agents-hosting-msteams
+Version: 1.8.0.dev0
+Summary: Integration library for Microsoft Agents with Teams
+Author: Microsoft Corporation
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/microsoft/Agents
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: microsoft-agents-hosting-core==1.8.0.dev0
+Requires-Dist: aiohttp>=3.11.11
+Requires-Dist: microsoft-teams-api==2.1.0
+Requires-Dist: msgraph-sdk>=1.58.0
+Dynamic: license-file
+Dynamic: requires-dist
+
 # microsoft-agents-hosting-msteams
 
 [![PyPI version](https://img.shields.io/pypi/v/microsoft-agents-hosting-msteams)](https://pypi.org/project/microsoft-agents-hosting-msteams/)
@@ -18,6 +41,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** — a compre
     <th style="width:20%">Date</th>
     <th style="width:60%">Release Notes</th>
   </tr>
+  <tr>
+    <td>1.8.0</td>
+    <td>2026-10-01</td>
+    <td>
+      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v180">
+        1.8.0 Release Notes
+      </a>
+    </td>
+  </tr>
   <tr>
     <td>1.7.0</td>
     <td>2026-09-17</td>
@@ -230,6 +262,10 @@ context.activity.notify_user(alert_in_meeting=True)
 
 # Attach a feedback loop to a message being sent (Copilot scenarios)
 context.activity.enable_feedback_loop()
+
+# Inspect quoted messages or targeted-message metadata
+quoted_messages = context.activity.get_quoted_messages()
+targeted_message = context.activity.get_targeted_message_info()
 ```
 
 #### `context.api_client` → `ApiClient`
@@ -238,13 +274,43 @@ Direct access to the Teams REST API client, pre-authenticated for the current tu
 
 #### Sending targeted activities
 
-`TeamsTurnContext` adds two methods for sending activities that target a specific user in a meeting:
+Use `TeamsTurnContext.send_targeted_activity()` to send a private activity to a
+specific user in a meeting or group conversation. Pass either the recipient ID
+or a `ChannelAccount`:
+
+```python
+await context.send_targeted_activity(
+    "Only you can see this message.",
+    recipient.id,
+)
+```
+
+Replies to inbound targeted activities automatically include the prompt-preview
+metadata required by Teams.
+
+#### Sending quoted replies
+
+Use `TeamsActivity.add_quoted_reply()` to quote an existing message:
 
 ```python
-await context.send_targeted_activity(activity)
-await context.send_targeted_activities([activity1, activity2])
+from microsoft_agents.activity import ActivityTypes
+from microsoft_agents.hosting.msteams import TeamsActivity
+
+message_id = context.activity.id
+if not message_id:
+    raise ValueError("Message ID is required for a quoted reply.")
+
+reply = TeamsActivity(type=ActivityTypes.message)
+reply.add_quoted_reply(
+    message_id,
+    "This response includes a quote of your message.",
+)
+await context.send_activity(reply)
 ```
 
+Use `context.activity.get_quoted_messages()` to inspect quoted messages on an
+incoming activity.
+
 ### Messaging Extensions
 
 ```python

{microsoft_agents_hosting_msteams-1.7.0.dev9 → microsoft_agents_hosting_msteams-1.8.0.dev0}/microsoft_agents_hosting_msteams.egg-info/SOURCES.txt

@@ -35,6 +35,9 @@ microsoft_agents/hosting/msteams/message/route_handlers.py
 microsoft_agents/hosting/msteams/message_extension/__init__.py
 microsoft_agents/hosting/msteams/message_extension/message_extension.py
 microsoft_agents/hosting/msteams/message_extension/route_handlers.py
+microsoft_agents/hosting/msteams/models/__init__.py
+microsoft_agents/hosting/msteams/models/quoted_reply.py
+microsoft_agents/hosting/msteams/models/targeted_message_info.py
 microsoft_agents/hosting/msteams/task_module/__init__.py
 microsoft_agents/hosting/msteams/task_module/route_handlers.py
 microsoft_agents/hosting/msteams/task_module/task_module.py

{microsoft_agents_hosting_msteams-1.7.0.dev9 → microsoft_agents_hosting_msteams-1.8.0.dev0}/microsoft_agents_hosting_msteams.egg-info/requires.txt

@@ -1,4 +1,4 @@
-microsoft-agents-hosting-core==1.7.0.dev9
+microsoft-agents-hosting-core==1.8.0.dev0
 aiohttp>=3.11.11
 microsoft-teams-api==2.1.0
 msgraph-sdk>=1.58.0

microsoft_agents_hosting_msteams-1.7.0.dev9/PKG-INFO → microsoft_agents_hosting_msteams-1.8.0.dev0/readme.md

@@ -1,26 +1,3 @@
-Metadata-Version: 2.4
-Name: microsoft-agents-hosting-msteams
-Version: 1.7.0.dev9
-Summary: Integration library for Microsoft Agents with Teams
-Author: Microsoft Corporation
-License-Expression: MIT
-Project-URL: Homepage, https://github.com/microsoft/Agents
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3.14
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: microsoft-agents-hosting-core==1.7.0.dev9
-Requires-Dist: aiohttp>=3.11.11
-Requires-Dist: microsoft-teams-api==2.1.0
-Requires-Dist: msgraph-sdk>=1.58.0
-Dynamic: license-file
-Dynamic: requires-dist
-
 # microsoft-agents-hosting-msteams
 
 [![PyPI version](https://img.shields.io/pypi/v/microsoft-agents-hosting-msteams)](https://pypi.org/project/microsoft-agents-hosting-msteams/)
@@ -41,6 +18,15 @@ This library is part of the **Microsoft 365 Agents SDK for Python** — a compre
     <th style="width:20%">Date</th>
     <th style="width:60%">Release Notes</th>
   </tr>
+  <tr>
+    <td>1.8.0</td>
+    <td>2026-10-01</td>
+    <td>
+      <a href="https://github.com/microsoft/Agents-for-python/blob/main/changelog.md#microsoft-365-agents-sdk-for-python---release-notes-v180">
+        1.8.0 Release Notes
+      </a>
+    </td>
+  </tr>
   <tr>
     <td>1.7.0</td>
     <td>2026-09-17</td>
@@ -253,6 +239,10 @@ context.activity.notify_user(alert_in_meeting=True)
 
 # Attach a feedback loop to a message being sent (Copilot scenarios)
 context.activity.enable_feedback_loop()
+
+# Inspect quoted messages or targeted-message metadata
+quoted_messages = context.activity.get_quoted_messages()
+targeted_message = context.activity.get_targeted_message_info()
 ```
 
 #### `context.api_client` → `ApiClient`
@@ -261,13 +251,43 @@ Direct access to the Teams REST API client, pre-authenticated for the current tu
 
 #### Sending targeted activities
 
-`TeamsTurnContext` adds two methods for sending activities that target a specific user in a meeting:
+Use `TeamsTurnContext.send_targeted_activity()` to send a private activity to a
+specific user in a meeting or group conversation. Pass either the recipient ID
+or a `ChannelAccount`:
+
+```python
+await context.send_targeted_activity(
+    "Only you can see this message.",
+    recipient.id,
+)
+```
+
+Replies to inbound targeted activities automatically include the prompt-preview
+metadata required by Teams.
+
+#### Sending quoted replies
+
+Use `TeamsActivity.add_quoted_reply()` to quote an existing message:
 
 ```python
-await context.send_targeted_activity(activity)
-await context.send_targeted_activities([activity1, activity2])
+from microsoft_agents.activity import ActivityTypes
+from microsoft_agents.hosting.msteams import TeamsActivity
+
+message_id = context.activity.id
+if not message_id:
+    raise ValueError("Message ID is required for a quoted reply.")
+
+reply = TeamsActivity(type=ActivityTypes.message)
+reply.add_quoted_reply(
+    message_id,
+    "This response includes a quote of your message.",
+)
+await context.send_activity(reply)
 ```
 
+Use `context.activity.get_quoted_messages()` to inspect quoted messages on an
+incoming activity.
+
 ### Messaging Extensions
 
 ```python

microsoft_agents_hosting_msteams-1.7.0.dev9/VERSION.txt

@@ -1 +0,0 @@
-1.7.0.dev9

microsoft_agents_hosting_msteams-1.7.0.dev9/microsoft_agents/hosting/msteams/_teams_api_client.py

@@ -1,76 +0,0 @@
-# Copyright (c) Microsoft Corporation. All rights reserved.
-# Licensed under the MIT License.
-
-"""Construction and caching of the Teams :class:`ApiClient` for a turn.
-
-The client is cached on turn context services so it is built at most once per turn, and
-is configured with a token factory derived from the turn's identity when one is
-available.
-"""
-
-from microsoft_teams.common import ClientOptions
-from microsoft_teams.api import ApiClient
-
-from microsoft_agents.hosting.core import (
-    Connections,
-    TurnContext,
-)
-
-
-def _get_teams_api_client(context: TurnContext) -> ApiClient:
-    """
-    Get the cached Teams API client from the context.
-
-    :param context: The turn context.
-    :return: The cached Teams API client.
-    :raises ValueError: If the Teams API client is not found.
-    """
-    api_client = context.services.get(ApiClient)
-    if isinstance(api_client, ApiClient):
-        return api_client
-    raise ValueError("Unable to retrieve Teams API client.")
-
-
-def _set_teams_api_client(
-    context: TurnContext, connection_manager: Connections
-) -> None:
-    """
-    Set the Teams API client in the context if it is not already set.
-
-    :param context: The turn context.
-    :param connection_manager: The connection manager.
-    """
-
-    if context.services.has(ApiClient):
-        return
-
-    headers = {
-        "Accept": "application/json",
-        "Content-Type": "application/json",
-    }
-
-    options: ClientOptions
-
-    if context.identity:
-        provider = connection_manager.get_token_provider(
-            context.identity, context.activity.service_url
-        )
-
-        async def token_factory() -> str:
-            return await provider.get_access_token(
-                "https://api.botframework.com",
-                ["https://api.botframework.com/.default"],
-            )
-
-        options = ClientOptions(
-            base_url=context.activity.service_url, headers=headers, token=token_factory
-        )
-    else:
-        options = ClientOptions(base_url=context.activity.service_url, headers=headers)
-
-    api_client = ApiClient(
-        context.activity.service_url,
-        options,
-    )
-
-    context.services.set(ApiClient, api_client)