defmodule Raxol.Agent.Supervisor do
  @moduledoc """
  Supervision subtree for the agent subsystem.

  Children:
  - `Raxol.Agent.Registry` -- unique Registry for agent discovery
  - `Raxol.Agent.DynSup` -- DynamicSupervisor for Agent.Process instances
  - `Raxol.Agent.Orchestrator` -- multi-agent coordinator

  Strategy is `:rest_for_one`: if the DynSup crashes, the Orchestrator
  restarts and rebuilds from ContextStore. If the Registry crashes,
  everything restarts.
  """

  use Supervisor

  @spec start_link(keyword()) :: {:ok, pid()}
  def start_link(opts \\ []) do
    Supervisor.start_link(__MODULE__, opts, name: __MODULE__)
  end

  @impl true
  def init(_opts) do
    children = [
      {Registry, keys: :unique, name: Raxol.Agent.Registry},
      {DynamicSupervisor, name: Raxol.Agent.DynSup, strategy: :one_for_one},
      Raxol.Agent.Orchestrator
    ]

    Supervisor.init(children, strategy: :rest_for_one)
  end
end