Function validate_tool_input 

pub fn validate_tool_input<Input>(
    tool_name: &str,
    raw: Value,
) -> Result<Input, ToolResult>
where
    Input: DeserializeOwned,

Deserialize raw model args into a typed Input, or synthesise the structured validation-error result.

Returns Ok(typed) for the happy path and Err(result) carrying the balanced error ToolResult for the self-correction path. TypedToolAdapter uses this to ensure TypedTool::execute is never reached with invalid arguments.

Errors

Returns the synthesised error ToolResult when raw does not deserialize into Input.