Behaviour for tool execution backends.

Executors are responsible for running tool operations (bash commands, file reads/writes) in an execution environment. Different executors provide different levels of isolation:

• Conjure.Executor.Local - Direct execution on host (no isolation)
• Conjure.Executor.Docker - Container-isolated execution

Implementing a Custom Executor

To create a custom executor, implement all required callbacks:

defmodule MyApp.FirecrackerExecutor do
  @behaviour Conjure.Executor

  @impl true
  def init(context) do
    # Start Firecracker microVM
    {:ok, %{context | vm_id: vm_id}}
  end

  @impl true
  def bash(command, context) do
    # Execute in microVM
    {:ok, output}
  end

  @impl true
  def view(path, context, opts) do
    # Read from microVM
    {:ok, content}
  end

  @impl true
  def create_file(path, content, context) do
    {:ok, "File created"}
  end

  @impl true
  def str_replace(path, old_str, new_str, context) do
    {:ok, "File updated"}
  end

  @impl true
  def cleanup(context) do
    # Shutdown microVM
    :ok
  end
end

Result Types

All execution callbacks return:

• {:ok, output} - Successful execution with string output
• {:ok, output, files} - Execution with output and generated files
• {:error, reason} - Execution failed