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/adapters/base.pyi

@@ -0,0 +1,10 @@
+from abc import ABC, abstractmethod
+from typing import Iterator, Dict, Any
+
+class MailIntakeAdapter(ABC):
+    @abstractmethod
+    def iter_message_refs(self, query: str) -> Iterator[Dict[str, str]]: ...
+    @abstractmethod
+    def fetch_message(self, message_id: str) -> Dict[str, Any]: ...
+    @abstractmethod
+    def fetch_thread(self, thread_id: str) -> Dict[str, Any]: ...