fix: Format email text as html (#94)

Author: yoomlam

app/poetry.lock

@@ -36,6 +36,7 @@ en-core-web-lg = {url = "https://github.com/explosion/spacy-models/releases/down
 pypdf = "^6.1.3"
 arize-phoenix = "^11.37.0"
 pip = ">=25.3"
+markdown = "^3.10"
 
 [tool.poetry.group.dev.dependencies]
 certifi = "^2025.8.3"
@@ -56,6 +57,7 @@ setuptools = "^78.1.1"
 debugpy = "^1.8.1"
 ruff = "^0.4.9"
 types-requests = "^2.32.4.20250913"
+types-markdown = "^3.9.0.20250906"
 
 [build-system]
 requires = ["poetry-core>=1.0.0"]

app/pyproject.toml

@@ -199,6 +199,16 @@ def run(
         return {"replies": [ChatMessage.from_assistant(response.output_text)]}
 
 
+EMAIL_INTRO = """\
+Hello,
+
+Here is your personalized report with resources your case manager recommends to support your goals.
+You've already taken a great first step by exploring these options.
+
+**Your next step**: Look over the resources to see contact info and details about how to get started.
+"""
+
+
 @component
 class EmailResult:
     """
@@ -210,7 +220,7 @@ def run(self, email: str, json_dict: dict) -> dict:
         logger.info("Emailing result to %s", email)
         logger.debug("JSON content:\n%s", json.dumps(json_dict, indent=2))
         formatted_resources = self.format_resources(json_dict.get("resources", []))
-        message = f"Here are the resources you requested:\n\n{formatted_resources}"
+        message = f"{EMAIL_INTRO}\n{formatted_resources}"
 
         # Send email via AWS SES
         subject = "Your Requested Resources"
@@ -225,14 +235,13 @@ def format_resources(self, resources: list[dict]) -> str:
     def format_resource(self, resource: dict) -> str:
         return "\n".join(
             [
-                f"{resource.get('name', 'Unnamed Resource')}",
+                f"### {resource.get('name', 'Unnamed Resource')}",
                 f"- Referral Type: {resource.get('referral_type', 'None')}",
                 f"- Description: {resource.get('description', 'None')}",
                 f"- Website: {resource.get('website', 'None')}",
                 f"- Phone: {', '.join(resource.get('phones', ['None']))}",
                 f"- Email: {', '.join(resource.get('emails', ['None']))}",
                 f"- Addresses: {', '.join(resource.get('addresses', ['None']))}",
-                f"- Justification: {resource.get('justification', 'None')}",
             ]
         )
 

app/src/common/components.py

@@ -1,6 +1,7 @@
 import logging
 
 import boto3
+import markdown
 from botocore.exceptions import ClientError
 
 from src.app_config import config
@@ -32,7 +33,7 @@ def send_email(recipient: str, subject: str, body: str) -> bool:
                 "Simple": {
                     "Subject": {"Data": subject, "Charset": "UTF-8"},
                     "Body": {
-                        "Html": {"Data": body, "Charset": "UTF-8"},
+                        "Html": {"Data": markdown.markdown(body), "Charset": "UTF-8"},
                         "Text": {"Data": body, "Charset": "UTF-8"},
                     },
                 }

app/src/common/send_email.py

@@ -115,25 +115,28 @@ def test_EmailResult(enable_factory_create, db_session: db.Session, monkeypatch)
     assert output["email"] == "test@example.com"
     assert output["message"] == dedent(
         """\
-        Here are the resources you requested:
+        Hello,
 
-        Resource 1
+        Here is your personalized report with resources your case manager recommends to support your goals.
+        You've already taken a great first step by exploring these options.
+
+        **Your next step**: Look over the resources to see contact info and details about how to get started.
+
+        ### Resource 1
         - Referral Type: external
         - Description: Description for Resource 1
         - Website: http://resource1.com
         - Phone: 555-1234
         - Email: resource1@example.com
         - Addresses: 123 Main St
-        - Justification: Justification for Resource 1
 
-        Resource 2
+        ### Resource 2
         - Referral Type: None
         - Description: None
         - Website: None
         - Phone: None
         - Email: None
-        - Addresses: None
-        - Justification: None"""
+        - Addresses: None"""
     )