Structured error type for Snakepit operations.

Provides detailed context for debugging cross-language and distributed system issues.

Error Categories

• :worker - Worker process errors (not found, crashed, etc.)
• :timeout - Operation timed out
• :python_error - Exception from Python code
• :grpc_error - gRPC communication error
• :validation - Input validation error
• :pool - Pool management error

Examples

# Create a worker error
error = Snakepit.Error.worker_error("Worker not found", %{worker_id: "w1"})

# Create a Python exception error
error = Snakepit.Error.python_error(
  "ValueError",
  "Invalid input",
  traceback_string,
  %{function: "process_data"}
)

# Pattern match in your code
case Snakepit.execute("command", %{}) do
  {:ok, result} -> result
  {:error, %Snakepit.Error{category: :timeout}} -> retry()
  {:error, %Snakepit.Error{category: :python_error} = error} ->
    Logger.error("Python error: #{error.message}")
    Logger.debug("Traceback: #{error.python_traceback}")
  {:error, error} -> {:error, error}
end