microsoft-agents-activity 0.4.0.dev10__py3-none-any.whl → 0.4.0.dev14__py3-none-any.whl

microsoft_agents/activity/_load_configuration.py

@@ -1,7 +1,7 @@
-from typing import Any, Dict
+from typing import Any
 
 
-def load_configuration_from_env(env_vars: Dict[str, Any]) -> dict:
+def load_configuration_from_env(env_vars: dict[str, Any]) -> dict:
     """
     Parses environment variables and returns a dictionary with the relevant configuration.
     """
@@ -18,6 +18,11 @@ def load_configuration_from_env(env_vars: Dict[str, Any]) -> dict:
             current_level = current_level[next_level]
         last_level[levels[-1]] = value
 
+    if result.get("CONNECTIONSMAP") and isinstance(result["CONNECTIONSMAP"], dict):
+        result["CONNECTIONSMAP"] = [
+            conn for conn in result.get("CONNECTIONSMAP", {}).values()
+        ]
+
     return {
         "AGENTAPPLICATION": result.get("AGENTAPPLICATION", {}),
         "CONNECTIONS": result.get("CONNECTIONS", {}),

microsoft_agents/activity/activity.py

@@ -20,6 +20,7 @@ from .conversation_reference import ConversationReference
 from .text_highlight import TextHighlight
 from .semantic_action import SemanticAction
 from .agents_model import AgentsModel
+from .role_types import RoleTypes
 from ._model_utils import pick_model, SkipNone
 from ._type_aliases import NonEmptyString
 
@@ -648,3 +649,21 @@ class Activity(AgentsModel):
                 self.entities = []
 
             self.entities.append(ai_entity)
+
+    def is_agentic_request(self) -> bool:
+        return self.recipient and self.recipient.role in [
+            RoleTypes.agentic_identity,
+            RoleTypes.agentic_user,
+        ]
+
+    def get_agentic_instance_id(self) -> Optional[str]:
+        """Gets the agent instance ID from the context if it's an agentic request."""
+        if not self.is_agentic_request() or not self.recipient:
+            return None
+        return self.recipient.agentic_app_id
+
+    def get_agentic_user(self) -> Optional[str]:
+        """Gets the agentic user (UPN) from the context if it's an agentic request."""
+        if not self.is_agentic_request() or not self.recipient:
+            return None
+        return self.recipient.id

microsoft_agents/activity/adaptive_card_invoke_value.py

@@ -10,9 +10,9 @@ class AdaptiveCardInvokeValue(AgentsModel):
     Defines the structure that arrives in the Activity.Value for Invoke activity with Name of 'adaptiveCard/action'.
 
     :param action: The action of this adaptive card invoke action value.
-    :type action: :class:`microsoft_agents.activity.models.AdaptiveCardInvokeAction`
+    :type action: :class:`microsoft_agents.activity.adaptive_card_invoke_action.AdaptiveCardInvokeAction`
     :param authentication: The TokenExchangeInvokeRequest for this adaptive card invoke action value.
-    :type authentication: :class:`microsoft_agents.activity.models.TokenExchangeInvokeRequest`
+    :type authentication: :class:`microsoft_agents.activity.token_exchange_invoke_request.TokenExchangeInvokeRequest`
     :param state: The 'state' or magic code for an OAuth flow.
     :type state: str
     """

microsoft_agents/activity/channel_account.py

@@ -26,6 +26,9 @@ class ChannelAccount(AgentsModel):
     name: str = None
     aad_object_id: NonEmptyString = None
     role: NonEmptyString = None
+    agentic_user_id: NonEmptyString = None
+    agentic_app_id: NonEmptyString = None
+    tenant_id: NonEmptyString = None
 
     @property
     def properties(self) -> dict[str, Any]:

microsoft_agents/activity/channels.py

@@ -10,6 +10,9 @@ class Channels(str, Enum):
     Ids of channels supported by ABS.
     """
 
+    """Agents channel."""
+    agents = "agents"
+
     console = "console"
     """Console channel."""
 

microsoft_agents/activity/role_types.py

@@ -5,3 +5,5 @@ class RoleTypes(str, Enum):
     user = "user"
     agent = "bot"
     skill = "skill"
+    agentic_identity = "agenticAppInstance"
+    agentic_user = "agenticUser"

microsoft_agents/activity/semantic_action.py

@@ -8,9 +8,9 @@ class SemanticAction(AgentsModel):
     :param id: ID of this action
     :type id: str
     :param entities: Entities associated with this action
-    :type entities: dict[str, ~microsoft_agents.activity.Entity]
+    :type entities: dict[str, :class:`microsoft_agents.activity.entity.Entity`]
     :param state: State of this action. Allowed values: `start`, `continue`, `done`
-    :type state: str or ~microsoft_agents.activity.SemanticActionStates
+    :type state: str or :class:`microsoft_agents.activity.semantic_action_states.SemanticActionStates`
     """
 
     id: NonEmptyString

microsoft_agents/activity/token_response.py

@@ -1,6 +1,8 @@
 # Copyright (c) Microsoft Corporation. All rights reserved.
 # Licensed under the MIT License.
 
+import jwt
+
 from .agents_model import AgentsModel
 from ._type_aliases import NonEmptyString
 
@@ -26,3 +28,19 @@ class TokenResponse(AgentsModel):
 
     def __bool__(self):
         return bool(self.token)
+
+    def is_exchangeable(self) -> bool:
+        """
+        Checks if a token is exchangeable (has api:// audience).
+
+        :param token: The token to check.
+        :type token: str
+        :return: True if the token is exchangeable, False otherwise.
+        """
+        try:
+            # Decode without verification to check the audience
+            payload = jwt.decode(self.token, options={"verify_signature": False})
+            aud = payload.get("aud")
+            return isinstance(aud, str) and aud.startswith("api://")
+        except Exception:
+            return False

{microsoft_agents_activity-0.4.0.dev10.dist-info → microsoft_agents_activity-0.4.0.dev14.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-activity
-Version: 0.4.0.dev10
+Version: 0.4.0.dev14
 Summary: A protocol library for Microsoft Agents
 Author: Microsoft Corporation
 Project-URL: Homepage, https://github.com/microsoft/Agents

{microsoft_agents_activity-0.4.0.dev10.dist-info → microsoft_agents_activity-0.4.0.dev14.dist-info}/RECORD

@@ -1,15 +1,15 @@
 microsoft_agents/activity/__init__.py,sha256=07QcOO-VhyFua5npkmn19vKzB_cPBixxSFDaDpYgUZA,5978
-microsoft_agents/activity/_load_configuration.py,sha256=Sepf-xe0pD_xuDwZEFmAEchMJURqIXmL2az78LIJLyw,833
+microsoft_agents/activity/_load_configuration.py,sha256=BBK-0lsTEZPThaEbtPIklWeAXrVDLwsCw_-rQ4NMYYg,1030
 microsoft_agents/activity/_model_utils.py,sha256=2y6TedLAIFGuaj-VWMZgiFHYt39Df10ed5j3aOAPLps,1909
 microsoft_agents/activity/_type_aliases.py,sha256=7kkx_rIxA1B-z2T6HU6OMBm5lgD1t6KGNznJzAX-VgE,135
 microsoft_agents/activity/action_types.py,sha256=DY0RkEFquJ_SjMKJvHsD5Ring4j_HPrchEvIsFunIfI,324
-microsoft_agents/activity/activity.py,sha256=ZDG9cdDC0EO2ZuARH0JHRFh2X4Da13c5c9LMLdU7tWw,27258
+microsoft_agents/activity/activity.py,sha256=ystruQkxfbwer-XDaNYzdVGNDkD38Bd9e_ahVAP1G2g,28014
 microsoft_agents/activity/activity_event_names.py,sha256=3X5u4xppN86wY-KpBAwRr4sfYB3-V4MSlB5SsrcI7l0,159
 microsoft_agents/activity/activity_importance.py,sha256=kdwdcVa9fsCEk5hvxOsGhqsE4uu7gpTYKtACEgmva0A,117
 microsoft_agents/activity/activity_types.py,sha256=a9XvGgWsFI1Rur4JC-n5YIDpdSooxqaMNna3VS1CW1s,667
 microsoft_agents/activity/adaptive_card_invoke_action.py,sha256=X4weYdv8uzeNyBPpeTYD4631O19aaQdvvyrYi5PUJdU,779
 microsoft_agents/activity/adaptive_card_invoke_response.py,sha256=lWlB9bL6I7F1Sr2-xV1XFq6ddB2UGi8GRCOOt4kyffs,640
-microsoft_agents/activity/adaptive_card_invoke_value.py,sha256=9AWQF2maf48GMAoWRgljquMZHZX1r_y3wqULprygJKI,995
+microsoft_agents/activity/adaptive_card_invoke_value.py,sha256=gv75JGisj9qiG3czFbRm7HL7Ir_65N1QlDGH-CbVO8k,1039
 microsoft_agents/activity/agents_model.py,sha256=3v3UOdEvNEGOyYPgk-3IP6cgtHdoYfeK_9x0VVrG6l4,1490
 microsoft_agents/activity/animation_card.py,sha256=Cqpuni9t19PIroPYiLiTSsaS_3o8tUOwTc_98bkuzv0,1994
 microsoft_agents/activity/attachment.py,sha256=Z2FtaHURYHPRDMdVWgeaxMlFENBMHCBCUKoRGEc2bVY,727
@@ -22,9 +22,9 @@ microsoft_agents/activity/basic_card.py,sha256=dLIGAPrxSwEqCo2tHLhX85Nm61aR5xowY
 microsoft_agents/activity/caller_id_constants.py,sha256=9VhHXo0XyTkknm6NTSGpHOLEMZQp7d3A5B5DOX5L0Kk,220
 microsoft_agents/activity/card_action.py,sha256=uVlxGFNE7H-ZIjE2YYESuuMDy24mp7MCvenhp83_xII,1414
 microsoft_agents/activity/card_image.py,sha256=yYyo8RBG3z1Heoorj3zEG32oMkLV_mzJWDJetRnszSg,545
-microsoft_agents/activity/channel_account.py,sha256=Vm-IEd6IjqXFFWS26afGThZZ8ysmAbtdy536_D4x5Hw,1000
+microsoft_agents/activity/channel_account.py,sha256=1VmdG3YRnAJrYAH67TMMowJ6pHsh_AnegUNUdP_UcW4,1122
 microsoft_agents/activity/channel_adapter_protocol.py,sha256=C-LTxx-EZ8GlRdfuMUx-tCxZrRTcyXQsbINUlM-Fnf0,2040
-microsoft_agents/activity/channels.py,sha256=DxdIMY_nBXA4BsbLKuL6A6BP0a8_RWvrdBSpR1kFYPY,4511
+microsoft_agents/activity/channels.py,sha256=irfa5KSKMwVuuZXLczyBDcPU_vzzezyWp8t9AJEckBs,4560
 microsoft_agents/activity/contact_relation_update_action_types.py,sha256=BWDcwhcw2xX2Bn2h_11uWNmcrGa_JV4ANbvmxP3Gqng,113
 microsoft_agents/activity/conversation_account.py,sha256=iFmtRUqPINXNie909SfnlwK0_lFiz8VxMt3old8G6W8,1441
 microsoft_agents/activity/conversation_members.py,sha256=Cw54xRDsZq_wWaXHiivu09chmfUVJbm_nu3lPJY_vjQ,457
@@ -55,8 +55,8 @@ microsoft_agents/activity/paged_members_result.py,sha256=ABwhTA3znOO0HCam1_-26lm
 microsoft_agents/activity/receipt_card.py,sha256=P-FQYuIsGGx9yLjpF8KZO4ZzaFf0rd_ocM5DOk0mRgU,1245
 microsoft_agents/activity/receipt_item.py,sha256=v6d7GBlB7nDGbV6ME8CRCkmzDhGzMRFhFVd5ybvsoLw,1107
 microsoft_agents/activity/resource_response.py,sha256=qTN6C2wXTP_euH5_LDL47DOfMfofe4_o1z7ZO39OEpU,255
-microsoft_agents/activity/role_types.py,sha256=Y-bnda7PFFBhXd-zZaL5RlIDbgAhdZbeW8TLV_fYjf0,108
-microsoft_agents/activity/semantic_action.py,sha256=HjkK0yq_w5hHLaP_DAsPNaBRReRplyupcvUroZeVQr8,595
+microsoft_agents/activity/role_types.py,sha256=k478TRb4KOW2-c5-u7Yf8YhLAhynq9Mrno2wi-oOX_M,185
+microsoft_agents/activity/semantic_action.py,sha256=a9-1synmnz0uG6MFtUrKfAe5i93-UiwlgtJjA0sG_D4,641
 microsoft_agents/activity/semantic_actions_states.py,sha256=xCcSWGmCKizL9J7lycEBIYPIGeQb2dQmsLLObph7s00,149
 microsoft_agents/activity/sign_in_constants.py,sha256=3juR-nSfP0vr3TvFPhQ2foEivt1lLgWxsG6LQmWhhkc,534
 microsoft_agents/activity/sign_in_resource.py,sha256=Ygy5wjCvyW1fQ5aLf29214_LFeF9zJnd7ZsUxice5JY,446
@@ -72,7 +72,7 @@ microsoft_agents/activity/token_exchange_resource.py,sha256=U5qptVUUZatpeQjuzFGr
 microsoft_agents/activity/token_exchange_state.py,sha256=C9QosBw52qItGhU5wiRUxkuixfni5Krh5BzftyuCzmo,1452
 microsoft_agents/activity/token_post_resource.py,sha256=GG65qizkE1v7VKqlQcKKFJky5XubQslrvAGK-BisCVw,226
 microsoft_agents/activity/token_request.py,sha256=ZXvYDCRaIydyzMuztfa0nQ3HMKURQJpvuTyzKbhukLo,448
-microsoft_agents/activity/token_response.py,sha256=jQbDEyQqApsF85Zse03D_FsW6ATGfN85-_ywh1ipf38,819
+microsoft_agents/activity/token_response.py,sha256=Zv-9uZ4UvB4TcS6NPklSoONv8WEbTwAkKROZi3UFglI,1413
 microsoft_agents/activity/token_status.py,sha256=o3pGTKRjuqEndRWClMe91Cmox6cW8aDrOTvE3_k5jFI,1174
 microsoft_agents/activity/transcript.py,sha256=yV5s5rONGC1uM5pKnVv0HbY2SVzQ9qKOBawM0fzJOJc,328
 microsoft_agents/activity/turn_context_protocol.py,sha256=ETR6L5aMoZdPkLUcULmDHfmQo21-_bFF_yzxZmiG_6g,1692
@@ -191,7 +191,7 @@ microsoft_agents/activity/teams/teams_member.py,sha256=vRcLRHy6wTfH7DP6k6QbrKkOR
 microsoft_agents/activity/teams/teams_paged_members_result.py,sha256=cG4eKHjA0u1EMioC2ErVpydnoPJrtTDcdhdzYET9xto,555
 microsoft_agents/activity/teams/tenant_info.py,sha256=h8OxMd6LD5lWVj_LK2ut8z7SB0I7Gx74W1wwEiYOzXk,296
 microsoft_agents/activity/teams/user_meeting_details.py,sha256=tvk2CWYf7Bo-DhK8NSojhanJDXEOGVrKXxJDca03CAo,467
-microsoft_agents_activity-0.4.0.dev10.dist-info/METADATA,sha256=e8dfD8X5222UK1sK8TqH6XNjiB9WBmiojgEX2pYit4c,414
-microsoft_agents_activity-0.4.0.dev10.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-microsoft_agents_activity-0.4.0.dev10.dist-info/top_level.txt,sha256=lWKcT4v6fTA_NgsuHdNvuMjSrkiBMXohn64ApY7Xi8A,17
-microsoft_agents_activity-0.4.0.dev10.dist-info/RECORD,,
+microsoft_agents_activity-0.4.0.dev14.dist-info/METADATA,sha256=thb-67BRzcCUdzxcJbLVWEoR5D1KEByi5ElEI-TNK-o,414
+microsoft_agents_activity-0.4.0.dev14.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+microsoft_agents_activity-0.4.0.dev14.dist-info/top_level.txt,sha256=lWKcT4v6fTA_NgsuHdNvuMjSrkiBMXohn64ApY7Xi8A,17
+microsoft_agents_activity-0.4.0.dev14.dist-info/RECORD,,