fix: GSDFC docstring conformance, modernize legacy typing to match signatures; regenerate lib/MCP docs (pydoclint zero)

mail_intake/adapters/base.py

@@ -41,8 +41,12 @@ class MailIntakeAdapter(ABC):
             query (str):
                 Provider-specific query string used to filter messages.
 
+        Returns:
+            Iterator[dict[str, str]]:
+                An iterator over lightweight message reference dictionaries.
+
         Yields:
-            Dict[str, str]:
+            dict[str, str]:
                 Dictionaries containing message and thread identifiers.
 
         Notes:
@@ -73,7 +77,7 @@ class MailIntakeAdapter(ABC):
                 Provider-specific message identifier.
 
         Returns:
-            Dict[str, Any]:
+            dict[str, Any]:
                 Provider-native message payload (e.g., Gmail message JSON structure).
         """
         raise NotImplementedError
@@ -88,7 +92,7 @@ class MailIntakeAdapter(ABC):
                 Provider-specific thread identifier.
 
         Returns:
-            Dict[str, Any]:
+            dict[str, Any]:
                 Provider-native thread payload.
         """
         raise NotImplementedError

mail_intake/adapters/gmail.py

@@ -72,10 +72,6 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
         """
         Lazily initialize and return the Gmail API service client.
 
-        Returns:
-            Any:
-                Initialized Gmail API service instance.
-
         Raises:
             MailIntakeAdapterError:
                 If the Gmail service cannot be initialized.
@@ -99,7 +95,7 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
                 Gmail search query string.
 
         Yields:
-            Dict[str, str]:
+            dict[str, str]:
                 Dictionaries containing ``message_id`` and ``thread_id``.
 
         Raises:
@@ -136,7 +132,7 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
                 Gmail message identifier.
 
         Returns:
-            Dict[str, Any]:
+            dict[str, Any]:
                 Provider-native Gmail message payload.
 
         Raises:
@@ -164,7 +160,7 @@ class MailIntakeGmailAdapter(MailIntakeAdapter):
                 Gmail thread identifier.
 
         Returns:
-            Dict[str, Any]:
+            dict[str, Any]:
                 Provider-native Gmail thread payload.
 
         Raises: