ergon-framework-python 0.2.2__tar.gz → 0.2.4__tar.gz

{ergon_framework_python-0.2.2/src/ergon_framework_python.egg-info → ergon_framework_python-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ergon-framework-python
-Version: 0.2.2
+Version: 0.2.4
 Summary: Ergon internal task-oriented project bootstrapper
 Author-email: Ergondata Technologies <anza.vossos@protonmail.com>
 License-Expression: MIT
@@ -31,6 +31,7 @@ Requires-Dist: asyncpg>=0.29.0; extra == "all"
 Requires-Dist: boto3>=1.35.0; extra == "all"
 Requires-Dist: ergon-platform-sdk>=0.2.0; extra == "all"
 Requires-Dist: httpx>=0.28.0; extra == "all"
+Requires-Dist: msal>=1.37.0; extra == "all"
 Requires-Dist: nylas>=6.0.0; extra == "all"
 Requires-Dist: openpyxl>=3.1.5; extra == "all"
 Requires-Dist: pika>=1.3.0; extra == "all"
@@ -42,6 +43,9 @@ Provides-Extra: excel
 Requires-Dist: openpyxl>=3.1.5; extra == "excel"
 Provides-Extra: nylas
 Requires-Dist: nylas>=6.0.0; extra == "nylas"
+Provides-Extra: outlook
+Requires-Dist: msal>=1.37.0; extra == "outlook"
+Requires-Dist: requests>=2.32.5; extra == "outlook"
 Provides-Extra: pipefy
 Requires-Dist: httpx>=0.28.0; extra == "pipefy"
 Requires-Dist: requests>=2.32.5; extra == "pipefy"
@@ -77,13 +81,53 @@ pull in client libraries that your application does not use:
 ```bash
 pip install 'ergon-framework-python[rabbitmq]'
 pip install 'ergon-framework-python[sqs,postgres]'
+pip install 'ergon-framework-python[outlook]'
 pip install 'ergon-framework-python[all]'
 ```
 
 Available extras are `rabbitmq`, `sqs`, `postgres`, `pipefy`, `excel`,
-`ergon-platform`, and `nylas`.
+`ergon-platform`, `nylas`, and `outlook`.
 
-For local development, install in editable mode:
+### Outlook / Microsoft Graph
+
+```bash
+pip install 'ergon-framework-python[outlook]'
+```
+
+The Outlook connector talks to Microsoft Graph with Entra **application**
+credentials. Consuming messages and attachments needs `Mail.Read`; marking,
+categorizing, moving, and deleting need `Mail.ReadWrite`; send, reply, and
+forward need `Mail.Send`. Graph `$filter` and `$search` cannot be combined.
+
+```python
+from ergon.connector.outlook import (
+    AsyncOutlookGraphConnector,
+    OutlookAckActionConfig,
+    OutlookConsumerConfig,
+    OutlookGraphClient,
+    OutlookMessageFilter,
+)
+
+client = OutlookGraphClient(
+    tenant_id="...",
+    client_id="...",
+    client_secret="...",
+    user_email="mailbox@example.com",
+)
+consumer = OutlookConsumerConfig(
+    folder_id="Inbox",
+    filter=OutlookMessageFilter(unread_only=True, has_attachments=True),
+    download_attachments=True,
+    ack_config=OutlookAckActionConfig(mark_as_read=True),
+)
+```
+
+Runnable example: [examples/outlook](https://github.com/danzanellovossos/ergon-framework/tree/main/sdks/python/examples/outlook).
+Module reference: [Outlook connector README](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/src/ergon/connector/outlook/README.md).
+
+### Local development
+
+Install in editable mode:
 
 ```bash
 pip install -e /path/to/ergon-framework/sdks/python

{ergon_framework_python-0.2.2 → ergon_framework_python-0.2.4}/README.md

@@ -20,13 +20,53 @@ pull in client libraries that your application does not use:
 ```bash
 pip install 'ergon-framework-python[rabbitmq]'
 pip install 'ergon-framework-python[sqs,postgres]'
+pip install 'ergon-framework-python[outlook]'
 pip install 'ergon-framework-python[all]'
 ```
 
 Available extras are `rabbitmq`, `sqs`, `postgres`, `pipefy`, `excel`,
-`ergon-platform`, and `nylas`.
+`ergon-platform`, `nylas`, and `outlook`.
 
-For local development, install in editable mode:
+### Outlook / Microsoft Graph
+
+```bash
+pip install 'ergon-framework-python[outlook]'
+```
+
+The Outlook connector talks to Microsoft Graph with Entra **application**
+credentials. Consuming messages and attachments needs `Mail.Read`; marking,
+categorizing, moving, and deleting need `Mail.ReadWrite`; send, reply, and
+forward need `Mail.Send`. Graph `$filter` and `$search` cannot be combined.
+
+```python
+from ergon.connector.outlook import (
+    AsyncOutlookGraphConnector,
+    OutlookAckActionConfig,
+    OutlookConsumerConfig,
+    OutlookGraphClient,
+    OutlookMessageFilter,
+)
+
+client = OutlookGraphClient(
+    tenant_id="...",
+    client_id="...",
+    client_secret="...",
+    user_email="mailbox@example.com",
+)
+consumer = OutlookConsumerConfig(
+    folder_id="Inbox",
+    filter=OutlookMessageFilter(unread_only=True, has_attachments=True),
+    download_attachments=True,
+    ack_config=OutlookAckActionConfig(mark_as_read=True),
+)
+```
+
+Runnable example: [examples/outlook](https://github.com/danzanellovossos/ergon-framework/tree/main/sdks/python/examples/outlook).
+Module reference: [Outlook connector README](https://github.com/danzanellovossos/ergon-framework/blob/main/sdks/python/src/ergon/connector/outlook/README.md).
+
+### Local development
+
+Install in editable mode:
 
 ```bash
 pip install -e /path/to/ergon-framework/sdks/python

{ergon_framework_python-0.2.2 → ergon_framework_python-0.2.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ergon-framework-python"
-version = "0.2.2"
+version = "0.2.4"
 description = "Ergon internal task-oriented project bootstrapper"
 readme = "README.md"
 license = "MIT"
@@ -36,6 +36,7 @@ all = [
     "boto3>=1.35.0",
     "ergon-platform-sdk>=0.2.0",
     "httpx>=0.28.0",
+    "msal>=1.37.0",
     "nylas>=6.0.0",
     "openpyxl>=3.1.5",
     "pika>=1.3.0",
@@ -47,6 +48,10 @@ all = [
 ]
 excel = ["openpyxl>=3.1.5"]
 nylas = ["nylas>=6.0.0"]
+outlook = [
+    "msal>=1.37.0",
+    "requests>=2.32.5",
+]
 pipefy = [
     "httpx>=0.28.0",
     "requests>=2.32.5",

{ergon_framework_python-0.2.2 → ergon_framework_python-0.2.4}/src/ergon/__init__.py

@@ -10,4 +10,4 @@ __all__ = [
     "manager",
 ]
 
-__version__ = "0.2.2"
+__version__ = "0.2.4"

{ergon_framework_python-0.2.2 → ergon_framework_python-0.2.4}/src/ergon/connector/__init__.py

@@ -43,6 +43,25 @@ if TYPE_CHECKING:
         NylasService,
         SendMessageInput,
     )
+    from .outlook import (
+        AsyncOutlookGraphConnector,
+        AsyncOutlookGraphService,
+        OutlookAckActionConfig,
+        OutlookAttachmentInput,
+        OutlookConsumerConfig,
+        OutlookEmailAddress,
+        OutlookFlagStatus,
+        OutlookGraphClient,
+        OutlookGraphConnector,
+        OutlookGraphService,
+        OutlookMessageFilter,
+        OutlookMessageQuery,
+        OutlookMessageSearch,
+        OutlookNackActionConfig,
+        OutlookProducerConfig,
+        OutlookSendMessageInput,
+        OutlookWellKnownFolder,
+    )
     from .postgres import (
         AsyncPostgresConnector,
         AsyncPostgresService,
@@ -78,6 +97,7 @@ _CONNECTOR_SUBPACKAGES = (
     "ergon_platform",
     "excel",
     "nylas",
+    "outlook",
     "pipefy",
     "postgres",
     "rabbitmq",
@@ -91,6 +111,8 @@ _LAZY_EXPORTS = {
     "AsyncNylasAuthService": "nylas",
     "AsyncNylasConnector": "nylas",
     "AsyncNylasService": "nylas",
+    "AsyncOutlookGraphConnector": "outlook",
+    "AsyncOutlookGraphService": "outlook",
     "AsyncPostgresConnector": "postgres",
     "AsyncPostgresService": "postgres",
     "AsyncRabbitMQConnector": "rabbitmq",
@@ -126,6 +148,21 @@ _LAZY_EXPORTS = {
     "NylasConsumerConfig": "nylas",
     "NylasProducerConfig": "nylas",
     "NylasService": "nylas",
+    "OutlookAckActionConfig": "outlook",
+    "OutlookAttachmentInput": "outlook",
+    "OutlookConsumerConfig": "outlook",
+    "OutlookEmailAddress": "outlook",
+    "OutlookFlagStatus": "outlook",
+    "OutlookGraphClient": "outlook",
+    "OutlookGraphConnector": "outlook",
+    "OutlookGraphService": "outlook",
+    "OutlookMessageFilter": "outlook",
+    "OutlookMessageQuery": "outlook",
+    "OutlookMessageSearch": "outlook",
+    "OutlookNackActionConfig": "outlook",
+    "OutlookProducerConfig": "outlook",
+    "OutlookSendMessageInput": "outlook",
+    "OutlookWellKnownFolder": "outlook",
     "PostgresClient": "postgres",
     "PostgresConsumerConfig": "postgres",
     "PostgresProducerConfig": "postgres",
@@ -168,6 +205,8 @@ __all__ = [
     "AsyncNylasAuthService",
     "AsyncNylasConnector",
     "AsyncNylasService",
+    "AsyncOutlookGraphConnector",
+    "AsyncOutlookGraphService",
     "AuthUrlConfig",
     "CodeExchangeInput",
     "GrantAuthResult",
@@ -205,6 +244,21 @@ __all__ = [
     "NylasConsumerConfig",
     "NylasProducerConfig",
     "NylasService",
+    "OutlookAckActionConfig",
+    "OutlookAttachmentInput",
+    "OutlookConsumerConfig",
+    "OutlookEmailAddress",
+    "OutlookFlagStatus",
+    "OutlookGraphClient",
+    "OutlookGraphConnector",
+    "OutlookGraphService",
+    "OutlookMessageFilter",
+    "OutlookMessageQuery",
+    "OutlookMessageSearch",
+    "OutlookNackActionConfig",
+    "OutlookProducerConfig",
+    "OutlookSendMessageInput",
+    "OutlookWellKnownFolder",
     "PostgresClient",
     "SendMessageInput",
     "PostgresConsumerConfig",

ergon_framework_python-0.2.4/src/ergon/connector/outlook/__init__.py

@@ -0,0 +1,67 @@
+from typing import TYPE_CHECKING, Any
+
+from .._lazy import exported_names, load_optional_export
+from .models import (
+    OutlookAckActionConfig,
+    OutlookAttachmentInput,
+    OutlookConsumerConfig,
+    OutlookEmailAddress,
+    OutlookFlagStatus,
+    OutlookGraphClient,
+    OutlookMessageFilter,
+    OutlookMessageQuery,
+    OutlookMessageSearch,
+    OutlookNackActionConfig,
+    OutlookProducerConfig,
+    OutlookSendMessageInput,
+    OutlookWellKnownFolder,
+)
+
+if TYPE_CHECKING:
+    from .async_connector import AsyncOutlookGraphConnector
+    from .async_service import AsyncOutlookGraphService
+    from .connector import OutlookGraphConnector
+    from .service import OutlookGraphService
+
+_LAZY_EXPORTS = {
+    "AsyncOutlookGraphConnector": "async_connector",
+    "AsyncOutlookGraphService": "async_service",
+    "OutlookGraphConnector": "connector",
+    "OutlookGraphService": "service",
+}
+
+
+def __getattr__(name: str) -> Any:
+    return load_optional_export(
+        name=name,
+        package=__name__,
+        exports=_LAZY_EXPORTS,
+        namespace=globals(),
+        extra="outlook",
+        dependencies=("msal", "requests"),
+    )
+
+
+def __dir__() -> list[str]:
+    return exported_names(globals(), _LAZY_EXPORTS)
+
+
+__all__ = [
+    "AsyncOutlookGraphConnector",
+    "AsyncOutlookGraphService",
+    "OutlookAckActionConfig",
+    "OutlookAttachmentInput",
+    "OutlookConsumerConfig",
+    "OutlookEmailAddress",
+    "OutlookFlagStatus",
+    "OutlookGraphClient",
+    "OutlookGraphConnector",
+    "OutlookGraphService",
+    "OutlookMessageFilter",
+    "OutlookMessageQuery",
+    "OutlookMessageSearch",
+    "OutlookNackActionConfig",
+    "OutlookProducerConfig",
+    "OutlookSendMessageInput",
+    "OutlookWellKnownFolder",
+]

ergon_framework_python-0.2.4/src/ergon/connector/outlook/async_connector.py

@@ -0,0 +1,198 @@
+import logging
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from ..connector import AsyncConnector
+from ..transaction import Transaction
+from .async_service import AsyncOutlookGraphService
+from .models import (
+    OutlookAckActionConfig,
+    OutlookConsumerConfig,
+    OutlookEmailAddress,
+    OutlookFlagStatus,
+    OutlookGraphClient,
+    OutlookMessageQuery,
+    OutlookNackActionConfig,
+    OutlookProducerConfig,
+    OutlookSendMessagePayload,
+    OutlookWellKnownFolder,
+)
+from .utils import build_ack_patch, build_nack_patch, merge_query
+
+logger = logging.getLogger(__name__)
+
+
+class AsyncOutlookGraphConnector(AsyncConnector):
+    service: AsyncOutlookGraphService
+
+    def __init__(
+        self,
+        client: OutlookGraphClient,
+        consumer_config: Optional[OutlookConsumerConfig] = None,
+        producer_config: Optional[OutlookProducerConfig] = None,
+    ) -> None:
+        self.service = AsyncOutlookGraphService(client)
+        self._consumer_config = consumer_config
+        self._producer_config = producer_config or OutlookProducerConfig()
+
+    async def fetch_transactions_async(
+        self,
+        batch_size: Optional[int] = None,
+        query_overrides: Optional[OutlookMessageQuery] = None,
+        *args: Any,
+        **kwargs: Any,
+    ) -> List[Transaction]:
+        if self._consumer_config is None:
+            raise ValueError("AsyncOutlookGraphConnector requires a consumer_config to fetch transactions")
+        config = self._consumer_config
+        return await self.service.fetch_items(
+            merge_query(config, query_overrides, **kwargs),
+            batch_size or config.batch_size,
+            download_attachments=config.download_attachments,
+        )
+
+    async def dispatch_transactions_async(
+        self,
+        transactions: List[Transaction],
+        *args: Any,
+        **kwargs: Any,
+    ) -> List[str]:
+        dispatched_ids: List[str] = []
+        for transaction in transactions:
+            await self.service.send_message(
+                transaction.payload,
+                producer_config=self._producer_config,
+            )
+            dispatched_ids.append(transaction.id)
+        return dispatched_ids
+
+    async def send_message(self, payload: OutlookSendMessagePayload) -> None:
+        await self.service.send_message(payload, producer_config=self._producer_config)
+
+    async def mark_as_read(self, message_id: str) -> Dict[str, Any]:
+        return await self.service.mark_as_read(message_id)
+
+    async def mark_as_unread(self, message_id: str) -> Dict[str, Any]:
+        return await self.service.mark_as_unread(message_id)
+
+    async def set_flag(
+        self,
+        message_id: str,
+        status: OutlookFlagStatus | str = OutlookFlagStatus.FLAGGED,
+    ) -> Dict[str, Any]:
+        return await self.service.set_flag(message_id, status)
+
+    async def set_categories(self, message_id: str, categories: List[str]) -> Dict[str, Any]:
+        return await self.service.set_categories(message_id, categories)
+
+    async def move_message(
+        self,
+        message_id: str,
+        folder_id: OutlookWellKnownFolder | str,
+    ) -> Dict[str, Any]:
+        return await self.service.move_message(message_id, folder_id)
+
+    async def delete_message(self, message_id: str) -> None:
+        await self.service.delete_message(message_id)
+
+    async def reply(self, message_id: str, *, comment: str = "") -> None:
+        await self.service.reply(message_id, comment=comment)
+
+    async def reply_all(self, message_id: str, *, comment: str = "") -> None:
+        await self.service.reply_all(message_id, comment=comment)
+
+    async def forward(
+        self,
+        message_id: str,
+        to: List[OutlookEmailAddress],
+        comment: str = "",
+    ) -> None:
+        await self.service.forward(message_id, to, comment=comment)
+
+    async def list_attachments(
+        self,
+        message_id: str,
+        download_content: bool = False,
+    ) -> List[Dict[str, Any]]:
+        return await self.service.list_attachments(message_id, download_content=download_content)
+
+    async def save_attachment(
+        self,
+        attachment: Dict[str, Any],
+        destination: str | Path,
+        overwrite: bool = False,
+    ) -> Path:
+        return await self.service.save_attachment(attachment, destination, overwrite=overwrite)
+
+    async def list_mail_folders(self, include_hidden: bool = False) -> List[Dict[str, Any]]:
+        return await self.service.list_mail_folders(include_hidden=include_hidden)
+
+    async def get_mail_folder(self, folder_id: OutlookWellKnownFolder | str) -> Dict[str, Any]:
+        return await self.service.get_mail_folder(folder_id)
+
+    async def reset_pagination(self) -> None:
+        await self.service.reset_pagination()
+
+    async def fetch_transaction_by_id_async(
+        self,
+        transaction_id: str,
+        *args: Any,
+        **kwargs: Any,
+    ) -> Transaction:
+        config = self._consumer_config
+        return await self.service.find_message_transaction(
+            transaction_id,
+            select=kwargs.get("select"),
+            download_attachments=config.download_attachments if config else False,
+        )
+
+    async def get_transactions_count_async(self, *args: Any, **kwargs: Any) -> int:
+        if self._consumer_config is None:
+            raise ValueError("AsyncOutlookGraphConnector requires a consumer_config to count transactions")
+        query_overrides = kwargs.pop("query_overrides", None)
+        max_pages = kwargs.pop("max_pages", None)
+        query = merge_query(self._consumer_config, query_overrides, **kwargs)
+        return await self.service.get_messages_count(query, max_pages=max_pages)
+
+    async def ack_transaction(
+        self,
+        transaction: Transaction,
+        ack_config: Optional[OutlookAckActionConfig] = None,
+    ) -> None:
+        config = ack_config or (self._consumer_config.ack_config if self._consumer_config else None)
+        if config is None:
+            return
+        if config.delete:
+            await self.service.delete_message(transaction.id)
+            return
+        patch = build_ack_patch(config)
+        if patch:
+            await self.service.update_message(transaction.id, patch)
+        if config.move_to_folder_id:
+            await self.service.move_message(transaction.id, config.move_to_folder_id)
+
+    async def nack_transaction(
+        self,
+        transaction: Transaction,
+        requeue: bool = True,
+        nack_config: Optional[OutlookNackActionConfig] = None,
+    ) -> None:
+        config = nack_config or (self._consumer_config.nack_config if self._consumer_config else None)
+        if config is None:
+            if not requeue:
+                raise ValueError("nack_config with a failure category or folder is required when requeue=False")
+            config = OutlookNackActionConfig()
+        if not requeue and not config.move_to_folder_id and not config.categories:
+            raise ValueError("nack_config with a failure category or folder is required when requeue=False")
+
+        patch = build_nack_patch(config)
+        if patch:
+            await self.service.update_message(transaction.id, patch)
+        if config.move_to_folder_id:
+            await self.service.move_message(transaction.id, config.move_to_folder_id)
+        if requeue:
+            await self.service.reset_pagination()
+            logger.debug("Outlook message %s was made available for refetch", transaction.id)
+
+    async def close(self) -> None:
+        await self.service.close()

ergon_framework_python-0.2.4/src/ergon/connector/outlook/async_service.py

@@ -0,0 +1,168 @@
+import asyncio
+from pathlib import Path
+from typing import Any, Dict, List, Optional
+
+from ..transaction import Transaction
+from .models import (
+    OutlookEmailAddress,
+    OutlookFlagStatus,
+    OutlookGraphClient,
+    OutlookMessageQuery,
+    OutlookProducerConfig,
+    OutlookSendMessagePayload,
+    OutlookWellKnownFolder,
+)
+from .service import OutlookGraphService
+
+
+class AsyncOutlookGraphService:
+    """Async facade over the blocking MSAL and requests implementations."""
+
+    def __init__(self, client: OutlookGraphClient) -> None:
+        self._sync = OutlookGraphService(client)
+
+    @property
+    def user_email(self) -> str:
+        return self._sync.user_email
+
+    async def close(self) -> None:
+        await asyncio.to_thread(self._sync.close)
+
+    async def reset_pagination(self) -> None:
+        self._sync.reset_pagination()
+
+    async def list_messages(
+        self,
+        query: OutlookMessageQuery,
+        limit: int,
+        next_link: Optional[str] = None,
+        use_internal_pagination: bool = True,
+    ) -> Dict[str, Any]:
+        return await asyncio.to_thread(
+            self._sync.list_messages,
+            query,
+            limit,
+            next_link=next_link,
+            use_internal_pagination=use_internal_pagination,
+        )
+
+    async def find_message(self, message_id: str, *, select: Optional[List[str]] = None) -> Dict[str, Any]:
+        return await asyncio.to_thread(self._sync.find_message, message_id, select=select)
+
+    async def list_attachments(
+        self,
+        message_id: str,
+        download_content: bool = False,
+    ) -> List[Dict[str, Any]]:
+        return await asyncio.to_thread(
+            self._sync.list_attachments,
+            message_id,
+            download_content=download_content,
+        )
+
+    async def save_attachment(
+        self,
+        attachment: Dict[str, Any],
+        destination: str | Path,
+        overwrite: bool = False,
+    ) -> Path:
+        return await asyncio.to_thread(
+            self._sync.save_attachment,
+            attachment,
+            destination,
+            overwrite=overwrite,
+        )
+
+    async def fetch_items(
+        self,
+        query: OutlookMessageQuery,
+        limit: int,
+        download_attachments: bool = False,
+    ) -> List[Transaction]:
+        return await asyncio.to_thread(
+            self._sync.fetch_items,
+            query,
+            limit,
+            download_attachments=download_attachments,
+        )
+
+    async def find_message_transaction(
+        self,
+        message_id: str,
+        select: Optional[List[str]] = None,
+        download_attachments: bool = False,
+    ) -> Transaction:
+        return await asyncio.to_thread(
+            self._sync.find_message_transaction,
+            message_id,
+            select=select,
+            download_attachments=download_attachments,
+        )
+
+    async def get_messages_count(
+        self,
+        query: OutlookMessageQuery,
+        max_pages: Optional[int] = None,
+    ) -> int:
+        return await asyncio.to_thread(self._sync.get_messages_count, query, max_pages=max_pages)
+
+    async def send_message(
+        self,
+        payload: OutlookSendMessagePayload,
+        producer_config: Optional[OutlookProducerConfig] = None,
+    ) -> None:
+        await asyncio.to_thread(
+            self._sync.send_message,
+            payload,
+            producer_config=producer_config,
+        )
+
+    async def update_message(self, message_id: str, request_body: Dict[str, Any]) -> Dict[str, Any]:
+        return await asyncio.to_thread(self._sync.update_message, message_id, request_body)
+
+    async def mark_as_read(self, message_id: str) -> Dict[str, Any]:
+        return await asyncio.to_thread(self._sync.mark_as_read, message_id)
+
+    async def mark_as_unread(self, message_id: str) -> Dict[str, Any]:
+        return await asyncio.to_thread(self._sync.mark_as_unread, message_id)
+
+    async def set_flag(
+        self,
+        message_id: str,
+        status: OutlookFlagStatus | str = OutlookFlagStatus.FLAGGED,
+    ) -> Dict[str, Any]:
+        return await asyncio.to_thread(self._sync.set_flag, message_id, status)
+
+    async def set_categories(self, message_id: str, categories: List[str]) -> Dict[str, Any]:
+        return await asyncio.to_thread(self._sync.set_categories, message_id, categories)
+
+    async def move_message(
+        self,
+        message_id: str,
+        folder_id: OutlookWellKnownFolder | str,
+    ) -> Dict[str, Any]:
+        return await asyncio.to_thread(self._sync.move_message, message_id, folder_id)
+
+    async def delete_message(self, message_id: str) -> None:
+        await asyncio.to_thread(self._sync.delete_message, message_id)
+
+    async def reply(self, message_id: str, *, comment: str = "") -> None:
+        await asyncio.to_thread(self._sync.reply, message_id, comment=comment)
+
+    async def reply_all(self, message_id: str, *, comment: str = "") -> None:
+        await asyncio.to_thread(self._sync.reply_all, message_id, comment=comment)
+
+    async def forward(
+        self,
+        message_id: str,
+        to: List[OutlookEmailAddress],
+        *,
+        comment: str = "",
+    ) -> None:
+        await asyncio.to_thread(self._sync.forward, message_id, to, comment=comment)
+
+    async def list_mail_folders(self, *, include_hidden: bool = False) -> List[Dict[str, Any]]:
+        return await asyncio.to_thread(self._sync.list_mail_folders, include_hidden=include_hidden)
+
+    async def get_mail_folder(self, folder_id: OutlookWellKnownFolder | str) -> Dict[str, Any]:
+        return await asyncio.to_thread(self._sync.get_mail_folder, folder_id)