docs-and-mcps (#1)

Reviewed-on: #1
Co-authored-by: Vishesh 'ironeagle' Bangotra <aetoskia@gmail.com>
Co-committed-by: Vishesh 'ironeagle' Bangotra <aetoskia@gmail.com>

mail_intake/models/__init__.pyi

@@ -0,0 +1,4 @@
+from .message import MailIntakeMessage
+from .thread import MailIntakeThread
+
+__all__ = ["MailIntakeMessage", "MailIntakeThread"]

mail_intake/models/message.pyi

@@ -0,0 +1,14 @@
+from datetime import datetime
+from typing import Optional, Dict
+
+class MailIntakeMessage:
+    message_id: str
+    thread_id: str
+    timestamp: datetime
+    from_email: str
+    from_name: Optional[str]
+    subject: str
+    body_text: str
+    snippet: str
+    raw_headers: Dict[str, str]
+    def __init__(self, message_id: str, thread_id: str, timestamp: datetime, from_email: str, from_name: Optional[str], subject: str, body_text: str, snippet: str, raw_headers: Dict[str, str]) -> None: ...

mail_intake/models/thread.pyi

@@ -0,0 +1,12 @@
+from datetime import datetime
+from typing import List, Set, Optional
+from .message import MailIntakeMessage
+
+class MailIntakeThread:
+    thread_id: str
+    normalized_subject: str
+    participants: Set[str]
+    messages: List[MailIntakeMessage]
+    last_activity_at: Optional[datetime]
+    def __init__(self, thread_id: str, normalized_subject: str, participants: Set[str] = ..., messages: List[MailIntakeMessage] = ..., last_activity_at: Optional[datetime] = ...) -> None: ...
+    def add_message(self, message: MailIntakeMessage) -> None: ...