ToolParam

Annotation to describe parameters of a tool method.

This annotation is required for all parameters of methods annotated with Tool (except ToolEmitter which is auto-injected). It provides metadata for generating JSON schemas that describe the tool's parameters to LLMs.

Usage Example:

`@Tool(name = "calculate_area", description = "Calculate rectangle area")
public double calculateArea(
@ToolParam(name = "width", description = "Width in meters", required = true)
double width,
@ToolParam(name = "height", description = "Height in meters", required = true)
double height,
@ToolParam(name = "unit", description = "Unit of measurement", required = false)
String unit
) {
// Implementation
}
`

Important Notes:

• The name attribute is required because Java does not preserve parameter names at runtime by default

• Parameter names should follow snake_case convention for LLM compatibility

• Descriptions help the LLM understand what values to provide

• ToolEmitter parameters do not need this annotation (they are framework-injected)