@spec execute(Normandy.Tools.Registry.t(), String.t(), execution_options()) ::
  execution_result()

Executes a tool by name from the registry.

Options

• :timeout - Maximum execution time in milliseconds (default: 30000)
• :max_retries - Number of retry attempts on failure (default: 0)

Examples

iex> registry = Normandy.Tools.Registry.new([%CalculatorTool{operation: :add, a: 5, b: 3}])
iex> Normandy.Tools.Executor.execute(registry, "calculator")
{:ok, 8}

iex> Normandy.Tools.Executor.execute(registry, "nonexistent")
{:error, "Tool 'nonexistent' not found in registry"}

@spec execute_parallel(
  Normandy.Tools.Registry.t(),
  [{String.t(), struct()}],
  execution_options()
) :: [
  execution_result()
]

Executes multiple tools in parallel.

Returns a list of results in the same order as the input tools.

Examples

iex> tools = [
...>   {"calc1", %CalculatorTool{operation: :add, a: 1, b: 2}},
...>   {"calc2", %CalculatorTool{operation: :multiply, a: 3, b: 4}}
...> ]
iex> Normandy.Tools.Executor.execute_parallel(registry, tools)
[
  {:ok, 3},
  {:ok, 12}
]

@spec execute_sequential(
  Normandy.Tools.Registry.t(),
  [String.t()],
  execution_options()
) ::
  {:ok, [term()]} | {:error, String.t()}

Executes multiple tools sequentially.

Stops execution if any tool returns an error (fail-fast behavior).

Examples

iex> tools = ["tool1", "tool2", "tool3"]
iex> Normandy.Tools.Executor.execute_sequential(registry, tools)
{:ok, [result1, result2, result3]}

@spec execute_tool(
  struct(),
  execution_options()
) :: execution_result()

Executes a tool instance directly.

Examples

iex> tool = %CalculatorTool{operation: :add, a: 2, b: 3}
iex> Normandy.Tools.Executor.execute_tool(tool)
{:ok, 5}