changed around the session API to simplify clients even further
documented session API, removed accidental .pyc files