Jido.AI.Reasoning.ReAct.ToolSelection (Jido AI v2.1.0)

Helpers for resolving request-scoped tool registries in ReAct.

This keeps tool selection deterministic across:

Summary

tools_input()

tools_map()

Filter a tool registry by allowed tool names.

Normalize arbitrary tool input into a validated action map.

Resolve an effective tool registry from a base registry plus optional overrides.

@type tools_input() :: nil | map() | [module()] | module()

@type tools_map() :: %{required(String.t()) => module()}

@spec filter_allowed(tools_map(), [String.t()] | nil) ::
  {:ok, tools_map()} | {:error, term()}

Filter a tool registry by allowed tool names.

@spec normalize_input(tools_input()) :: {:ok, tools_map()} | {:error, term()}

Normalize arbitrary tool input into a validated action map.

@spec resolve(tools_map(), tools_input(), [String.t()] | nil) ::
  {:ok, tools_map()} | {:error, term()}

Resolve an effective tool registry from a base registry plus optional overrides.

override_tools replaces the base registry for the current request/run when present. allowed_tools filters the selected registry by tool name.