Alex gmail improvements

toolkits/google/arcade_google/tools/constants.py

@@ -0,0 +1,18 @@
+import os
+
+from arcade_google.tools.models import GmailReplyToWhom
+
+# The default reply in Gmail is to only the sender. Since Gmail also offers the possibility of
+# changing the default to 'reply to all', we support both options through an env variable.
+# https://support.google.com/mail/answer/6585?hl=en&sjid=15399867888091633568-SA#null
+try:
+    GMAIL_DEFAULT_REPLY_TO = GmailReplyToWhom(
+        # Values accepted are defined in the arcade_google.tools.models.GmailReplyToWhom Enum
+        os.getenv("ARCADE_GMAIL_DEFAULT_REPLY_TO", GmailReplyToWhom.ONLY_THE_SENDER.value).lower()
+    )
+except ValueError as e:
+    raise ValueError(
+        "Invalid value for ARCADE_GMAIL_DEFAULT_REPLY_TO: "
+        f"'{os.getenv('ARCADE_GMAIL_DEFAULT_REPLY_TO')}'. Expected one of "
+        f"{list(GmailReplyToWhom.__members__.keys())}"
+    ) from e

toolkits/google/arcade_google/tools/exceptions.py

@@ -0,0 +1,43 @@
+class GoogleToolError(Exception):
+    """Base exception for Google tool errors."""
+
+    def __init__(self, message: str, developer_message: str | None = None):
+        self.message = message
+        self.developer_message = developer_message
+        super().__init__(self.message)
+
+    def __str__(self) -> str:
+        base_message = self.message
+        if self.developer_message:
+            return f"{base_message} (Developer: {self.developer_message})"
+        return base_message
+
+
+class GoogleServiceError(GoogleToolError):
+    """Raised when there's an error building or using the Google service."""
+
+    pass
+
+
+class GmailToolError(GoogleToolError):
+    """Raised when there's an error in the Gmail tools."""
+
+    pass
+
+
+class GoogleCalendarToolError(GoogleToolError):
+    """Raised when there's an error in the Google Calendar tools."""
+
+    pass
+
+
+class GoogleDriveToolError(GoogleToolError):
+    """Raised when there's an error in the Google Drive tools."""
+
+    pass
+
+
+class GoogleDocsToolError(GoogleToolError):
+    """Raised when there's an error in the Google Docs tools."""
+
+    pass