Add helper functions for creating activity with email response

Author: joratz

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/agent_notification.py

@@ -3,12 +3,13 @@
 from collections.abc import Awaitable, Callable, Iterable
 from typing import Any, TypeVar
 
-from microsoft_agents.activity import ChannelId
+from microsoft_agents.activity import Activity, ChannelId
 from microsoft_agents.hosting.core import TurnContext
 from microsoft_agents.hosting.core.app.state import TurnState
 from .models.agent_notification_activity import AgentNotificationActivity, NotificationTypes
 from .models.agent_subchannel import AgentSubChannel
 from .models.agent_lifecycle_event import AgentLifecycleEvent
+from .models.email_response import EmailResponse
 
 TContext = TypeVar("TContext", bound=TurnContext)
 TState = TypeVar("TState", bound=TurnState)
@@ -181,3 +182,14 @@ def _normalize_lifecycleevent(value: str | AgentLifecycleEvent | None) -> str:
             return ""
         resolved = value.value if isinstance(value, AgentLifecycleEvent) else str(value)
         return resolved.lower().strip()
+
+    @staticmethod
+    def create_email_response_activity(
+        activity: Activity, email_response_html_body: str
+    ) -> Activity:
+        working_activity = activity.create_reply()
+        email_response = EmailResponse(html_body=email_response_html_body)
+        if working_activity.entities is None:
+            working_activity.entities = []
+        working_activity.entities.append(email_response)
+        return working_activity

libraries/microsoft-agents-a365-notifications/microsoft_agents_a365/notifications/models/email_response.py

@@ -1,7 +1,17 @@
 from typing import Literal
+from microsoft_agents.activity.activity import Activity
 from microsoft_agents.activity.entity import Entity
 
 
 class EmailResponse(Entity):
     type: Literal["emailResponse"] = "emailResponse"
     html_body: str = ""
+
+    @staticmethod
+    def create_email_response_activity(email_response_html_body: str) -> Activity:
+        working_activity = Activity(type="message")
+        email_response = EmailResponse(html_body=email_response_html_body)
+        if working_activity.entities is None:
+            working_activity.entities = []
+        working_activity.entities.append(email_response)
+        return working_activity