feat(email): add PDF attachment support via report_id

README.md

@@ -39,7 +39,7 @@ An MCP (Model Context Protocol) tool server providing NYC infrastructure data fo
 | `weather_get_current` | Get current weather + hazard assessment (real data via Weather.gov) | `lat`, `lon` |
 | `get_department_info` | Get NYC department contact info and SLA targets (real data via NYC 311 SLA) | `department_code` |
 | `pdf_generate_report` | Generate real PDF report (via ReportLab) | `issue_type`, `address`, `urgency`, `description` |
-| `sendgrid_send_email` | Send email via Resend API (test mode - routes to test sink) | `to`, `subject`, `body`, `api_key`, `from_email` |
+| `sendgrid_send_email` | Send email via Resend API (test mode - routes to test sink) | `to`, `subject`, `body`, `api_key`, `from_email`, `report_id` |
 
 ## Use with Claude Desktop
 
@@ -129,6 +129,21 @@ Local MCP endpoint: `http://localhost:7860/gradio_api/mcp/sse`
 | `pdf_generate_report` | ReportLab (local generation) | N/A |
 | `sendgrid_send_email` | Resend API (test sink: `delivered@resend.dev`) | Safe demo mode |
 
+## Complete Report Flow
+
+The server supports a production-ready flow with safety guardrails:
+
+```
+1. pdf_generate_report()  →  Creates PDF, returns report_id (e.g., "FMN-20251127050500")
+2. sendgrid_send_email(report_id="FMN-20251127050500")  →  Attaches PDF to email
+                                                        →  Routes to test sink (delivered@resend.dev)
+```
+
+**Safety Features:**
+- All emails route to `delivered@resend.dev` (Resend test sink)
+- From address uses `onboarding@resend.dev` (no domain verification needed)
+- Real Resend API is exercised, but no emails reach municipal inboxes
+
 ## Hackathon Track
 
 **Track 1: Building MCP** - This server demonstrates how to build MCP tools with Gradio that can be used by any MCP-compatible client (Claude Desktop, AI agents, etc.).

app.py

@@ -114,11 +114,12 @@ email_interface = gr.Interface(
         gr.Textbox(label="Subject", value="Infrastructure Issue Report"),
         gr.Textbox(label="Body", lines=3, value="Please see attached report for infrastructure issue details."),
         gr.Textbox(label="API Key (optional)", value="", type="password", placeholder="Resend API key (or set RESEND_API_KEY env var)"),
-        gr.Textbox(label="From Email (optional)", value="", placeholder="Sender email (or set RESEND_FROM_EMAIL env var)")
+        gr.Textbox(label="From Email (optional)", value="", placeholder="Sender email (or set RESEND_FROM_EMAIL env var)"),
+        gr.Textbox(label="Report ID (optional)", value="", placeholder="Report ID to attach PDF (e.g., FMN-20251127050500)")
     ],
     outputs=gr.JSON(label="Email Status"),
     title="Send Email",
-    description="Send email report to municipal department. Provide API key or set RESEND_API_KEY env var.",
+    description="Send email report to municipal department with optional PDF attachment.",
     api_name="sendgrid_send_email"
 )
 

tools/email.py

@@ -1,4 +1,7 @@
 """Email notification using Resend API."""
+import os
+import base64
+import tempfile
 from datetime import datetime
 from tools.email_client import send_email as resend_send_email, is_configured
 
@@ -8,7 +11,8 @@ def sendgrid_send_email(
     subject: str,
     body: str,
     api_key: str = "",
-    from_email: str = ""
+    from_email: str = "",
+    report_id: str = ""
 ) -> dict:
     """
     Send an email notification using Resend API (demo mode - sends to test address).
@@ -22,6 +26,7 @@ def sendgrid_send_email(
         body: Email body text
         api_key: Resend API key (optional, defaults to RESEND_API_KEY env var)
         from_email: Sender email (optional, defaults to RESEND_FROM_EMAIL env var)
+        report_id: Report ID to attach PDF (optional, e.g., "FMN-20251127050500")
 
     Returns:
         dict: Send result with status and message ID
@@ -29,6 +34,30 @@ def sendgrid_send_email(
     # Test email address that Resend accepts
     TEST_EMAIL = "delivered@resend.dev"
 
+    # Look for PDF attachment if report_id provided
+    attachments = None
+    attachment_info = None
+    if report_id:
+        pdf_path = os.path.join(tempfile.gettempdir(), f"{report_id}.pdf")
+        if os.path.exists(pdf_path):
+            with open(pdf_path, "rb") as f:
+                pdf_content = base64.b64encode(f.read()).decode("utf-8")
+            attachments = [{
+                "filename": f"{report_id}.pdf",
+                "content": pdf_content
+            }]
+            attachment_info = {
+                "filename": f"{report_id}.pdf",
+                "size_bytes": os.path.getsize(pdf_path),
+                "attached": True
+            }
+        else:
+            attachment_info = {
+                "filename": f"{report_id}.pdf",
+                "attached": False,
+                "error": "PDF not found - generate report first"
+            }
+
     # If no API key provided or in env, return demo mode response
     if not is_configured(api_key if api_key else None):
         return {
@@ -38,6 +67,7 @@ def sendgrid_send_email(
             "actual_recipient": "none (no API key)",
             "subject": subject,
             "body_preview": body[:100] + "..." if len(body) > 100 else body,
+            "attachment": attachment_info,
             "timestamp": datetime.now().isoformat(),
             "note": "Demo mode: No API key configured.",
             "source": "demo"
@@ -49,12 +79,14 @@ def sendgrid_send_email(
         subject=f"[Test] {subject}",
         body=f"Intended recipient: {to}\n\n{body}",
         api_key=api_key if api_key else None,
-        from_email=from_email if from_email else None
+        from_email=from_email if from_email else None,
+        attachments=attachments
     )
 
     # Add context about test mode
     result["intended_recipient"] = to
     result["actual_recipient"] = TEST_EMAIL
+    result["attachment"] = attachment_info
     result["timestamp"] = datetime.now().isoformat()
     result["body_preview"] = body[:100] + "..." if len(body) > 100 else body
     result["note"] = "Test mode: Email sent to Resend test address, not actual recipient."