microsoft-agents-hosting-teams 0.6.0.dev9__tar.gz → 0.6.0.dev10__tar.gz

{microsoft_agents_hosting_teams-0.6.0.dev9/microsoft_agents_hosting_teams.egg-info → microsoft_agents_hosting_teams-0.6.0.dev10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-hosting-teams
-Version: 0.6.0.dev9
+Version: 0.6.0.dev10
 Summary: Integration library for Microsoft Agents with Teams
 Author: Microsoft Corporation
 License-Expression: MIT
@@ -15,7 +15,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: microsoft-agents-hosting-core==0.6.0.dev9
+Requires-Dist: microsoft-agents-hosting-core==0.6.0.dev10
 Requires-Dist: aiohttp>=3.11.11
 Dynamic: license-file
 Dynamic: requires-dist

microsoft_agents_hosting_teams-0.6.0.dev10/microsoft_agents/hosting/teams/errors/__init__.py

@@ -0,0 +1,15 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+"""
+Error resources for Microsoft Agents Hosting Teams package.
+"""
+
+from microsoft_agents.hosting.core.errors import ErrorMessage
+
+from .error_resources import TeamsErrorResources
+
+# Singleton instance
+teams_errors = TeamsErrorResources()
+
+__all__ = ["ErrorMessage", "TeamsErrorResources", "teams_errors"]

microsoft_agents_hosting_teams-0.6.0.dev10/microsoft_agents/hosting/teams/errors/error_resources.py

@@ -0,0 +1,82 @@
+# Copyright (c) Microsoft Corporation. All rights reserved.
+# Licensed under the MIT License.
+
+"""
+Teams error resources for Microsoft Agents SDK.
+
+Error codes are in the range -62000 to -62999.
+"""
+
+from microsoft_agents.hosting.core.errors import ErrorMessage
+
+
+class TeamsErrorResources:
+    """
+    Error messages for Teams operations.
+
+    Error codes are organized in the range -62000 to -62999.
+    """
+
+    TeamsBadRequest = ErrorMessage(
+        "BadRequest",
+        -62000,
+        "teams-integration",
+    )
+
+    TeamsNotImplemented = ErrorMessage(
+        "NotImplemented",
+        -62001,
+        "teams-integration",
+    )
+
+    TeamsContextRequired = ErrorMessage(
+        "context is required.",
+        -62002,
+        "teams-integration",
+    )
+
+    TeamsMeetingIdRequired = ErrorMessage(
+        "meeting_id is required.",
+        -62003,
+        "teams-integration",
+    )
+
+    TeamsParticipantIdRequired = ErrorMessage(
+        "participant_id is required.",
+        -62004,
+        "teams-integration",
+    )
+
+    TeamsTeamIdRequired = ErrorMessage(
+        "team_id is required.",
+        -62005,
+        "teams-integration",
+    )
+
+    TeamsTurnContextRequired = ErrorMessage(
+        "TurnContext cannot be None",
+        -62006,
+        "teams-integration",
+    )
+
+    TeamsActivityRequired = ErrorMessage(
+        "Activity cannot be None",
+        -62007,
+        "teams-integration",
+    )
+
+    TeamsChannelIdRequired = ErrorMessage(
+        "The teams_channel_id cannot be None or empty",
+        -62008,
+        "teams-integration",
+    )
+
+    TeamsConversationIdRequired = ErrorMessage(
+        "conversation_id is required.",
+        -62009,
+        "teams-integration",
+    )
+
+    def __init__(self):
+        """Initialize TeamsErrorResources."""
+        pass

{microsoft_agents_hosting_teams-0.6.0.dev9 → microsoft_agents_hosting_teams-0.6.0.dev10}/microsoft_agents/hosting/teams/teams_activity_handler.py

@@ -7,6 +7,7 @@ from http import HTTPStatus
 from typing import Any, List
 
 from microsoft_agents.hosting.core import ActivityHandler, TurnContext
+from microsoft_agents.hosting.teams.errors import teams_errors
 from microsoft_agents.activity import (
     InvokeResponse,
     ChannelAccount,
@@ -155,9 +156,9 @@ class TeamsActivityHandler(ActivityHandler):
                 else:
                     return await super().on_invoke_activity(turn_context)
         except Exception as err:
-            if str(err) == "NotImplemented":
+            if str(err) == str(teams_errors.TeamsNotImplemented):
                 return InvokeResponse(status=int(HTTPStatus.NOT_IMPLEMENTED))
-            elif str(err) == "BadRequest":
+            elif str(err) == str(teams_errors.TeamsBadRequest):
                 return InvokeResponse(status=int(HTTPStatus.BAD_REQUEST))
             raise
 
@@ -170,7 +171,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param turn_context: The context object for the turn.
         :return: An InvokeResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_config_fetch(
         self, turn_context: TurnContext, config_data: Any
@@ -182,7 +183,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param config_data: The config data.
         :return: A ConfigResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_config_submit(
         self, turn_context: TurnContext, config_data: Any
@@ -194,7 +195,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param config_data: The config data.
         :return: A ConfigResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_file_consent(
         self,
@@ -217,7 +218,7 @@ class TeamsActivityHandler(ActivityHandler):
                 turn_context, file_consent_card_response
             )
         else:
-            raise ValueError("BadRequest")
+            raise ValueError(str(teams_errors.TeamsBadRequest))
 
     async def on_teams_file_consent_accept(
         self,
@@ -231,7 +232,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param file_consent_card_response: The file consent card response.
         :return: None
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_file_consent_decline(
         self,
@@ -245,7 +246,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param file_consent_card_response: The file consent card response.
         :return: None
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_o365_connector_card_action(
         self, turn_context: TurnContext, query: O365ConnectorCardActionQuery
@@ -257,7 +258,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param query: The O365 connector card action query.
         :return: None
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_signin_verify_state(
         self, turn_context: TurnContext, query: SigninStateVerificationQuery
@@ -269,7 +270,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param query: The sign-in state verification query.
         :return: None
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_signin_token_exchange(
         self, turn_context: TurnContext, query: SigninStateVerificationQuery
@@ -281,7 +282,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param query: The sign-in state verification query.
         :return: None
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_app_based_link_query(
         self, turn_context: TurnContext, query: AppBasedLinkQuery
@@ -293,7 +294,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param query: The app-based link query.
         :return: A MessagingExtensionResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_anonymous_app_based_link_query(
         self, turn_context: TurnContext, query: AppBasedLinkQuery
@@ -305,7 +306,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param query: The app-based link query.
         :return: A MessagingExtensionResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_messaging_extension_query(
         self, turn_context: TurnContext, query: MessagingExtensionQuery
@@ -317,7 +318,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param query: The messaging extension query.
         :return: A MessagingExtensionResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_messaging_extension_select_item(
         self, turn_context: TurnContext, query: Any
@@ -329,7 +330,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param query: The query.
         :return: A MessagingExtensionResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_messaging_extension_submit_action_dispatch(
         self, turn_context: TurnContext, action: MessagingExtensionAction
@@ -351,7 +352,7 @@ class TeamsActivityHandler(ActivityHandler):
                     turn_context, action
                 )
             else:
-                raise ValueError("BadRequest")
+                raise ValueError(str(teams_errors.TeamsBadRequest))
         else:
             return await self.on_teams_messaging_extension_submit_action(
                 turn_context, action
@@ -367,7 +368,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param action: The messaging extension action.
         :return: A MessagingExtensionActionResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_messaging_extension_message_preview_edit(
         self, turn_context: TurnContext, action: MessagingExtensionAction
@@ -379,7 +380,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param action: The messaging extension action.
         :return: A MessagingExtensionActionResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_messaging_extension_message_preview_send(
         self, turn_context: TurnContext, action: MessagingExtensionAction
@@ -391,7 +392,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param action: The messaging extension action.
         :return: A MessagingExtensionActionResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_messaging_extension_fetch_task(
         self, turn_context: TurnContext, action: MessagingExtensionAction
@@ -403,7 +404,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param action: The messaging extension action.
         :return: A MessagingExtensionActionResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_messaging_extension_configuration_query_setting_url(
         self, turn_context: TurnContext, query: MessagingExtensionQuery
@@ -415,7 +416,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param query: The messaging extension query.
         :return: A MessagingExtensionResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_messaging_extension_configuration_setting(
         self, turn_context: TurnContext, settings: Any
@@ -427,7 +428,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param settings: The settings.
         :return: None
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_messaging_extension_card_button_clicked(
         self, turn_context: TurnContext, card_data: Any
@@ -439,7 +440,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param card_data: The card data.
         :return: None
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_task_module_fetch(
         self, turn_context: TurnContext, task_module_request: TaskModuleRequest
@@ -451,7 +452,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param task_module_request: The task module request.
         :return: A TaskModuleResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_task_module_submit(
         self, turn_context: TurnContext, task_module_request: TaskModuleRequest
@@ -463,7 +464,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param task_module_request: The task module request.
         :return: A TaskModuleResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_tab_fetch(
         self, turn_context: TurnContext, tab_request: TabRequest
@@ -475,7 +476,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param tab_request: The tab request.
         :return: A TabResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_teams_tab_submit(
         self, turn_context: TurnContext, tab_submit: TabSubmit
@@ -487,7 +488,7 @@ class TeamsActivityHandler(ActivityHandler):
         :param tab_submit: The tab submit.
         :return: A TabResponse.
         """
-        raise NotImplementedError("NotImplemented")
+        raise NotImplementedError(str(teams_errors.TeamsNotImplemented))
 
     async def on_conversation_update_activity(self, turn_context: TurnContext):
         """

{microsoft_agents_hosting_teams-0.6.0.dev9 → microsoft_agents_hosting_teams-0.6.0.dev10}/microsoft_agents/hosting/teams/teams_info.py

@@ -23,7 +23,12 @@ from microsoft_agents.activity.teams import (
     ChannelInfo,
 )
 from microsoft_agents.hosting.core.connector.teams import TeamsConnectorClient
-from microsoft_agents.hosting.core import ChannelServiceAdapter, TurnContext
+from microsoft_agents.hosting.core import (
+    ChannelServiceAdapter,
+    TurnContext,
+    error_resources,
+)
+from microsoft_agents.hosting.teams.errors import teams_errors
 
 
 class TeamsInfo:
@@ -52,7 +57,7 @@ class TeamsInfo:
             ValueError: If required parameters are missing.
         """
         if not context:
-            raise ValueError("context is required.")
+            raise ValueError(str(teams_errors.TeamsContextRequired))
 
         activity = context.activity
         teams_channel_data: dict = activity.channel_data
@@ -61,13 +66,13 @@ class TeamsInfo:
             meeting_id = teams_channel_data.get("meeting", {}).get("id", None)
 
         if not meeting_id:
-            raise ValueError("meeting_id is required.")
+            raise ValueError(str(teams_errors.TeamsMeetingIdRequired))
 
         if participant_id is None:
             participant_id = getattr(activity.from_property, "aad_object_id", None)
 
         if not participant_id:
-            raise ValueError("participant_id is required.")
+            raise ValueError(str(teams_errors.TeamsParticipantIdRequired))
 
         if tenant_id is None:
             tenant_id = teams_channel_data.get("tenant", {}).get("id", None)
@@ -100,7 +105,7 @@ class TeamsInfo:
             meeting_id = teams_channel_data.get("meeting", {}).get("id", None)
 
         if not meeting_id:
-            raise ValueError("meeting_id is required.")
+            raise ValueError(str(teams_errors.TeamsMeetingIdRequired))
 
         rest_client = TeamsInfo._get_rest_client(context)
         result = await rest_client.fetch_meeting_info(meeting_id)
@@ -128,7 +133,7 @@ class TeamsInfo:
             team_id = teams_channel_data.get("team", {}).get("id", None)
 
         if not team_id:
-            raise ValueError("team_id is required.")
+            raise ValueError(str(teams_errors.TeamsTeamIdRequired))
 
         rest_client = TeamsInfo._get_rest_client(context)
         result = await rest_client.fetch_team_details(team_id)
@@ -157,13 +162,13 @@ class TeamsInfo:
             ValueError: If required parameters are missing.
         """
         if not context:
-            raise ValueError("TurnContext cannot be None")
+            raise ValueError(str(teams_errors.TeamsTurnContextRequired))
 
         if not activity:
-            raise ValueError("Activity cannot be None")
+            raise ValueError(str(teams_errors.TeamsActivityRequired))
 
         if not teams_channel_id:
-            raise ValueError("The teams_channel_id cannot be None or empty")
+            raise ValueError(str(teams_errors.TeamsChannelIdRequired))
 
         convo_params = ConversationParameters(
             is_group=True,
@@ -239,7 +244,7 @@ class TeamsInfo:
             team_id = teams_channel_data.get("team", {}).get("id", None)
 
         if not team_id:
-            raise ValueError("team_id is required.")
+            raise ValueError(str(teams_errors.TeamsTeamIdRequired))
 
         rest_client = TeamsInfo._get_rest_client(context)
         return await rest_client.fetch_channel_list(team_id)
@@ -278,7 +283,7 @@ class TeamsInfo:
                 else None
             )
             if not conversation_id:
-                raise ValueError("conversation_id is required.")
+                raise ValueError(str(teams_errors.TeamsConversationIdRequired))
 
             rest_client = TeamsInfo._get_rest_client(context)
             return await rest_client.get_conversation_paged_member(
@@ -312,7 +317,7 @@ class TeamsInfo:
                 else None
             )
             if not conversation_id:
-                raise ValueError("conversation_id is required.")
+                raise ValueError(str(teams_errors.TeamsConversationIdRequired))
 
             return await TeamsInfo._get_member_internal(
                 context, conversation_id, user_id
@@ -345,7 +350,7 @@ class TeamsInfo:
             team_id = teams_channel_data.get("team", {}).get("id", None)
 
         if not team_id:
-            raise ValueError("team_id is required.")
+            raise ValueError(str(teams_errors.TeamsTeamIdRequired))
 
         rest_client = TeamsInfo._get_rest_client(context)
         paged_results = await rest_client.get_conversation_paged_member(
@@ -410,7 +415,7 @@ class TeamsInfo:
             meeting_id = teams_channel_data.get("meeting", {}).get("id", None)
 
         if not meeting_id:
-            raise ValueError("meeting_id is required.")
+            raise ValueError(str(teams_errors.TeamsMeetingIdRequired))
 
         rest_client = TeamsInfo._get_rest_client(context)
         return await rest_client.send_meeting_notification(meeting_id, notification)
@@ -438,9 +443,11 @@ class TeamsInfo:
             ValueError: If required parameters are missing.
         """
         if not activity:
-            raise ValueError("activity is required.")
+            raise ValueError(str(error_resources.ActivityRequired))
         if not tenant_id:
-            raise ValueError("tenant_id is required.")
+            raise ValueError(
+                error_resources.RequiredParameterMissing.format("tenant_id")
+            )
         if not members or len(members) == 0:
             raise ValueError("members list is required.")
 
@@ -468,9 +475,11 @@ class TeamsInfo:
             ValueError: If required parameters are missing.
         """
         if not activity:
-            raise ValueError("activity is required.")
+            raise ValueError(str(error_resources.ActivityRequired))
         if not tenant_id:
-            raise ValueError("tenant_id is required.")
+            raise ValueError(
+                error_resources.RequiredParameterMissing.format("tenant_id")
+            )
 
         rest_client = TeamsInfo._get_rest_client(context)
         return await rest_client.send_message_to_all_users_in_tenant(
@@ -497,11 +506,13 @@ class TeamsInfo:
             ValueError: If required parameters are missing.
         """
         if not activity:
-            raise ValueError("activity is required.")
+            raise ValueError(str(error_resources.ActivityRequired))
         if not tenant_id:
-            raise ValueError("tenant_id is required.")
+            raise ValueError(
+                error_resources.RequiredParameterMissing.format("tenant_id")
+            )
         if not team_id:
-            raise ValueError("team_id is required.")
+            raise ValueError(str(teams_errors.TeamsTeamIdRequired))
 
         rest_client = TeamsInfo._get_rest_client(context)
         return await rest_client.send_message_to_all_users_in_team(
@@ -531,9 +542,11 @@ class TeamsInfo:
             ValueError: If required parameters are missing.
         """
         if not activity:
-            raise ValueError("activity is required.")
+            raise ValueError(str(error_resources.ActivityRequired))
         if not tenant_id:
-            raise ValueError("tenant_id is required.")
+            raise ValueError(
+                error_resources.RequiredParameterMissing.format("tenant_id")
+            )
         if not members or len(members) == 0:
             raise ValueError("members list is required.")
 

{microsoft_agents_hosting_teams-0.6.0.dev9 → microsoft_agents_hosting_teams-0.6.0.dev10/microsoft_agents_hosting_teams.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: microsoft-agents-hosting-teams
-Version: 0.6.0.dev9
+Version: 0.6.0.dev10
 Summary: Integration library for Microsoft Agents with Teams
 Author: Microsoft Corporation
 License-Expression: MIT
@@ -15,7 +15,7 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: microsoft-agents-hosting-core==0.6.0.dev9
+Requires-Dist: microsoft-agents-hosting-core==0.6.0.dev10
 Requires-Dist: aiohttp>=3.11.11
 Dynamic: license-file
 Dynamic: requires-dist

{microsoft_agents_hosting_teams-0.6.0.dev9 → microsoft_agents_hosting_teams-0.6.0.dev10}/microsoft_agents_hosting_teams.egg-info/SOURCES.txt

@@ -6,6 +6,8 @@ microsoft_agents/hosting/teams/__init__.py
 microsoft_agents/hosting/teams/teams_activity_handler.py
 microsoft_agents/hosting/teams/teams_cloud_adapter.py
 microsoft_agents/hosting/teams/teams_info.py
+microsoft_agents/hosting/teams/errors/__init__.py
+microsoft_agents/hosting/teams/errors/error_resources.py
 microsoft_agents_hosting_teams.egg-info/PKG-INFO
 microsoft_agents_hosting_teams.egg-info/SOURCES.txt
 microsoft_agents_hosting_teams.egg-info/dependency_links.txt

microsoft_agents_hosting_teams-0.6.0.dev10/microsoft_agents_hosting_teams.egg-info/requires.txt

@@ -0,0 +1,2 @@
+microsoft-agents-hosting-core==0.6.0.dev10
+aiohttp>=3.11.11

microsoft_agents_hosting_teams-0.6.0.dev9/microsoft_agents_hosting_teams.egg-info/requires.txt

@@ -1,2 +0,0 @@
-microsoft-agents-hosting-core==0.6.0.dev9
-aiohttp>=3.11.11