@spec agent(String.t()) :: map() | nil

@spec agents() :: [map()]

@spec approve_recommendation(String.t()) :: {:ok, map()} | {:error, term()}

@spec cluster_info() :: Syntropy.ClusterInfo.info()

@spec cluster_report() :: Syntropy.ClusterMonitor.report()

@spec events(non_neg_integer()) :: [map()]

@spec join(String.t(), String.t()) :: {:ok, String.t()} | {:error, term()}

@spec meet(String.t(), String.t()) :: {:ok, String.t()} | {:error, term()}

@spec node_id() :: String.t()

@spec recent_events(non_neg_integer()) :: [map()]

@spec recent_recommendations(non_neg_integer()) :: [map()]

@spec recent_runs(non_neg_integer()) :: [map()]

@spec recent_snapshots(non_neg_integer()) :: [map()]

@spec recent_tasks(non_neg_integer()) :: [map()]

@spec recommendation(String.t()) :: map() | nil

@spec reject_recommendation(String.t()) :: {:ok, map()} | {:error, term()}

@spec run(String.t()) :: map() | nil

@spec snapshot(String.t()) :: map() | nil

@spec start_run(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, term()}

@spec submit(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, term()}

@spec task(String.t()) :: map() | nil

@spec think(String.t(), String.t()) :: {:ok, String.t()} | {:error, term()}