docs: clean up class docstrings in agents, models, memories

camel/memories/records.py

@@ -185,7 +185,12 @@ def to_openai_message(self) -> OpenAIMessage:
 
 
 class ContextRecord(BaseModel):
-    r"""The result of memory retrieving."""
+    r"""The result of memory retrieving.
+
+    Args:
+        memory_record (MemoryRecord): The retrieved record.
+        score (float): Relevance score from the retrieval.
+    """
 
     memory_record: MemoryRecord
     score: float

camel/models/base_audio_model.py

@@ -22,6 +22,14 @@
 class BaseAudioModel(ABC):
     r"""Base class for audio models providing Text-to-Speech (TTS) and
     Speech-to-Text (STT) functionality.
+
+    Args:
+        api_key (Optional[str], optional): API key for the service.
+            (default: :obj:`None`)
+        url (Optional[str], optional): Base URL for the API.
+            (default: :obj:`None`)
+        timeout (Optional[float], optional): Request timeout in
+            seconds. (default: :obj:`Constants.TIMEOUT_THRESHOLD`)
     """
 
     def __init__(

camel/models/model_manager.py

@@ -60,7 +60,7 @@ class ModelManager:
             model backend or list of model backends
             (e.g., model instances, APIs)
         scheduling_strategy (str): name of function that defines how
-            to select the next model. (default: :str:`round_robin`)
+            to select the next model. (default: :obj:`round_robin`)
     """
 
     def __init__(

camel/models/openai_audio_models.py

@@ -23,7 +23,17 @@
 
 class OpenAIAudioModels(BaseAudioModel):
     r"""Provides access to OpenAI's Text-to-Speech (TTS) and Speech_to_Text
-    (STT) models."""
+    (STT) models.
+
+    Args:
+        api_key (Optional[str], optional): OpenAI API key.
+            Falls back to :obj:`OPENAI_API_KEY` env var.
+            (default: :obj:`None`)
+        url (Optional[str], optional): Base URL override.
+            (default: :obj:`None`)
+        timeout (Optional[float], optional): Request timeout.
+            (default: :obj:`None`)
+    """
 
     def __init__(
         self,

camel/models/stub_model.py

@@ -31,6 +31,8 @@
 
 
 class StubTokenCounter(BaseTokenCounter):
+    r"""Simple token counter that returns a constant value."""
+
     def count_tokens_from_messages(self, messages: List[OpenAIMessage]) -> int:
         r"""Token counting for STUB models, directly returning a constant.
 
@@ -71,7 +73,20 @@ def decode(self, token_ids: List[int]) -> str:
 
 
 class StubModel(BaseModelBackend):
-    r"""A dummy model used for unit tests."""
+    r"""A dummy model used for unit tests.
+
+    Args:
+        model_type (Union[ModelType, str]): Model type identifier.
+        model_config_dict (Optional[Dict[str, Any]], optional):
+            Configuration dict. (default: :obj:`None`)
+        api_key (Optional[str], optional): API key (unused).
+            (default: :obj:`None`)
+        url (Optional[str], optional): URL (unused).
+            (default: :obj:`None`)
+        token_counter (Optional[BaseTokenCounter], optional):
+            Token counter instance.
+            (default: :obj:`None`)
+    """
 
     model_type = ModelType.STUB