support better para check

Author: gasvn

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "tooluniverse"
-version = "1.0.15.2"
+version = "1.0.15.3"
 description = "A comprehensive collection of scientific tools for Agentic AI, offering integration with the ToolUniverse SDK and MCP Server to support advanced scientific workflows."
 authors = [
     { name = "Shanghua Gao", email = "shanghuagao@gmail.com" }

src/tooluniverse/base_tool.py

@@ -194,12 +194,29 @@ def validate_parameters(self, arguments: Dict[str, Any]) -> Optional[ToolError]:
             jsonschema.validate(filtered_arguments, schema)
             return None
         except jsonschema.ValidationError as e:
+            # Create a more agent-friendly error message
+            error_msg = f"Parameter validation failed for '{e.path[-1] if e.path else 'root'}': {e.message}"
+
+            # Add type hint if it's a type error
+            if e.validator == "type":
+                error_msg += (
+                    f". Expected {e.validator_value}, got {type(e.instance).__name__}."
+                )
+
+            # Add allowed values if it's an enum error
+            if e.validator == "enum":
+                error_msg += f". Allowed values: {e.validator_value}."
+
             return ToolValidationError(
-                f"Parameter validation failed: {e.message}",
+                error_msg,
                 details={
                     "validation_error": str(e),
                     "path": list(e.absolute_path) if e.absolute_path else [],
                     "schema": schema,
+                    "parameter": str(e.path[-1]) if e.path else "root",
+                    "expected": str(e.validator_value)
+                    if hasattr(e, "validator_value")
+                    else None,
                 },
             )
         except Exception as e:

src/tooluniverse/tools/execute_tool.py

@@ -15,6 +15,7 @@ def execute_tool(
     stream_callback: Optional[Callable[[str], None]] = None,
     use_cache: bool = False,
     validate: bool = True,
+    **kwargs: Any,
 ) -> dict[str, Any]:
     """
     Execute a ToolUniverse tool directly with custom arguments. This is the primary way to run any to...