docs: added missing docstrings

Author: jmatejcz

src/rai_bench/rai_bench/tool_calling_agent/interfaces.py

@@ -121,6 +121,30 @@ def _check_tool_call(
     def _check_nested_fields(
         self, field_path: str, args: Dict[str, Any], expected_value: Any
     ) -> bool:
+        """Check if a nested field in the arguments matches the expected value.
+
+        Parameters
+        ----------
+        field_path : str
+            Dot-separated path to the field (e.g., "header.frame_id").
+            Including indexes for lists possible (e.g., "data[0].value").
+        args : Dict[str, Any]
+            The arguments dictionary to check.
+        expected_value : Any
+            The expected value for the field.
+
+        Returns
+        -------
+        bool
+            True if the field matches the expected value, False otherwise.
+
+
+        Raises
+        ------
+        SubTaskValidationError
+            If the field is not found or does not match the expected value.
+        """
+
         keys = field_path.split(".")
         value: Any = args
         for key in keys:

src/rai_bench/rai_bench/tool_calling_agent/mocked_tools.py

@@ -270,8 +270,10 @@ def _run(self, msg_type: str) -> str:
 
 class ServiceValidator:
     """
-    Hybrid validator that uses ROS 2 native types when available,
-    falls back to Pydantic models of custom interfaces
+    Validator that is responsible for checking if gicen service type exists
+    and if it is used correctly.
+    Validator uses ROS 2 native types when available,
+    falls back to Pydantic models of custom interfaces when not.
     """
 
     def __init__(self, custom_models: Dict[str, Type[BaseModel]]):