Tool definition behaviour and inline tool creation.

Tools can be defined as modules implementing the behaviour, or inline using new/1.

Module Tool

defmodule MyApp.Tools.ReadFile do
  @behaviour LLM.Tool

  @impl true
  def name, do: "read_file"

  @impl true
  def description, do: "Read the contents of a file"

  @impl true
  def input_schema do
    %{
      "type" => "object",
      "properties" => %{
        "path" => %{"type" => "string", "description" => "File path"}
      },
      "required" => ["path"]
    }
  end

  @impl true
  def execute(%{"path" => path}, _context) do
    File.read(path)
  end
end

Inline Tool

LLM.Tool.new(%{
  name: "shell",
  description: "Execute a shell command",
  input_schema: %{
    "type" => "object",
    "properties" => %{
      "command" => %{"type" => "string"}
    },
    "required" => ["command"]
  },
  run: fn %{"command" => cmd} ->
    {output, _} = System.cmd("sh", ["-c", cmd])
    {:ok, output}
  end
})