chore: Improve variable names and docstring for more clarity

Author: anubhav756

packages/toolbox-core/src/toolbox_core/tool.py

@@ -18,6 +18,7 @@
 from inspect import Signature
 from typing import (
     Any,
+    Awaitable,
     Callable,
     Iterable,
     Mapping,
@@ -181,12 +182,12 @@ async def __call__(self, *args: Any, **kwargs: Any) -> str:
 
         # apply bounded parameters
         for param, value in self.__bound_parameters.items():
-            payload[param] = await get_value(value)
+            payload[param] = await resolve_value(value)
 
         # create headers for auth services
         headers = {}
         for auth_service, token_getter in self.__auth_service_token_getters.items():
-            headers[f"{auth_service}_token"] = await get_value(token_getter)
+            headers[f"{auth_service}_token"] = await resolve_value(token_getter)
 
         async with self.__session.post(
             self.__url,
@@ -328,10 +329,21 @@ def params_to_pydantic_model(
     return create_model(tool_name, **field_definitions)
 
 
-async def get_value(func: Callable[[], Any]) -> Any:
-    """Asynchronously or synchronously gets the value from a callable."""
-    if asyncio.iscoroutinefunction(func):
-        return await func()
-    elif callable(func):
-        return func()
-    return func
+async def resolve_value(
+    source: Union[Callable[[], Awaitable[Any]], Callable[[], Any], Any],
+) -> Any:
+    """
+    Asynchronously or synchronously resolves a given source to its value.
+
+    Args:
+        source: The value, a callable returning a value, or a callable
+                returning an awaitable value.
+
+    Returns:
+        The resolved value.
+    """
+    if asyncio.iscoroutinefunction(source):
+        return await source()
+    elif callable(source):
+        return source()
+    return source