ExAthena.Tools (ExAthena v0.3.0)

Resolves tool modules into the shape the provider + loop expect.

Consumers supply tools in one of two ways:

At config time:

config :ex_athena, tools: [MyApp.ToolA, MyApp.ToolB]

Per-call:

ExAthena.Loop.run(messages, tools: [MyApp.ToolA, ExAthena.Tools.Read])

Per-call wins; the configured list is the default when no tools are passed.

Summary

builtins()

List the builtin tool modules.

Build the prompt-friendly list used by ExAthena.ToolCalls.augment_system_prompt/2 when we fall back to the TextTagged protocol.

Build the provider-facing tool schema list — the same shape Ollama / OpenAI-compatible providers send on the wire.

Find the tool module that handles a call by name.

resolve(opts)

Resolve the tools to use for a call. Accepts

Validate that every module in modules implements the Tool behaviour.

@spec builtins() :: [module()]

List the builtin tool modules.

@spec describe_for_prompt([module()]) :: [map()]

Build the prompt-friendly list used by ExAthena.ToolCalls.augment_system_prompt/2 when we fall back to the TextTagged protocol.

@spec describe_for_provider([module()]) :: [map()]

Build the provider-facing tool schema list — the same shape Ollama / OpenAI-compatible providers send on the wire.

@spec find([module()], String.t()) :: module() | nil

Find the tool module that handles a call by name.

@spec resolve(keyword()) :: [module()]

Resolve the tools to use for a call. Accepts:

@spec validate!([module()]) :: :ok

Validate that every module in modules implements the Tool behaviour.