LlmCore.Tool.Validator (llm_core v0.3.0)

Validates tool call arguments against a tool's JSON Schema parameters.

Performs lightweight, built-in validation without requiring an external JSON Schema library. Checks:

Required fields exist
Basic type checks (string, number, integer, boolean, array, object)
Enum membership when "enum" is specified in a property schema

This is intentionally a subset of JSON Schema validation — sufficient for catching malformed LLM tool calls without pulling in a full schema validator dependency.

Summary

Functions

validate_call(call, tool)

Validates that a tool call's arguments satisfy the tool's parameter schema.

Functions

validate_call(call, tool)

@spec validate_call(LlmToolkit.Tool.Call.t(), LlmToolkit.Tool.t()) ::
  :ok | {:error, [String.t()]}

Validates that a tool call's arguments satisfy the tool's parameter schema.

Returns :ok when valid, or {:error, reasons} with a list of human-readable error strings.

Examples

iex> tool = %LlmToolkit.Tool{
...>   name: "search",
...>   description: "Search",
...>   parameters: %{
...>     "type" => "object",
...>     "properties" => %{
...>       "query" => %{"type" => "string"},
...>       "limit" => %{"type" => "integer"}
...>     },
...>     "required" => ["query"]
...>   },
...>   metadata: %{}
...> }
iex> call = %LlmToolkit.Tool.Call{id: "1", name: "search", arguments: %{"query" => "hello"}}
iex> LlmCore.Tool.Validator.validate_call(call, tool)
:ok

iex> bad_call = %LlmToolkit.Tool.Call{id: "2", name: "search", arguments: %{}}
iex> LlmCore.Tool.Validator.validate_call(bad_call, tool)
{:error, ["missing required field: query"]}