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/ingestion/reader.pyi

@@ -0,0 +1,10 @@
+from typing import Iterator, Dict, Any
+from mail_intake.adapters.base import MailIntakeAdapter
+from mail_intake.models.message import MailIntakeMessage
+from mail_intake.models.thread import MailIntakeThread
+
+class MailIntakeReader:
+    def __init__(self, adapter: MailIntakeAdapter) -> None: ...
+    def iter_messages(self, query: str) -> Iterator[MailIntakeMessage]: ...
+    def iter_threads(self, query: str) -> Iterator[MailIntakeThread]: ...
+    def _parse_message(self, raw_message: Dict[str, Any]) -> MailIntakeMessage: ...