add message list method and tests

adds list and filter support for Messages

also an example program