fix: Add comment to explain how to use mentions (#77)

signalbot/api.py

@@ -1,5 +1,6 @@
 import aiohttp
 import websockets
+from typing import Any
 
 
 class SignalAPI:
@@ -33,7 +34,7 @@ async def send(
         quote_mentions: list = None,
         quote_message: str = None,
         quote_timestamp: str = None,
-        mentions: list = None,
+        mentions: list[dict[str, Any]] | None = None,
         text_mode: str = None,
     ) -> aiohttp.ClientResponse:
         uri = self._send_rest_uri()

signalbot/bot.py

@@ -4,7 +4,7 @@
 from apscheduler.schedulers.asyncio import AsyncIOScheduler
 import logging
 import traceback
-from typing import Optional, Union, List, Callable
+from typing import Optional, Union, List, Callable, Any
 import re
 import uuid
 
@@ -181,7 +181,9 @@ async def send(
         quote_mentions: list = None,
         quote_message: str = None,
         quote_timestamp: str = None,
-        mentions: list = None,
+        mentions: (
+            list[dict[str, Any]] | None
+        ) = None,  # [{ "author": "uuid" , "start": 0, "length": 1 }]
         text_mode: str = None,
         listen: bool = False,
     ) -> int:

signalbot/context.py

@@ -1,5 +1,6 @@
 # from .bot import Signalbot # TODO: figure out how to enable this for typing
 from .message import Message
+from typing import Any
 
 
 class Context:
@@ -26,7 +27,9 @@ async def reply(
         self,
         text: str,
         base64_attachments: list = None,
-        mentions: list = None,
+        mentions: (
+            list[dict[str, Any]] | None
+        ) = None,  # [{ "author": "uuid" , "start": 0, "length": 1 }]
         text_mode: str = None,
     ):
         return await self.bot.send(