Add API endpoint to get online/offline/away/idle status, plus away message if possible

[CoherentLogic]

Description of the feature

Management API endpoint that can, for a given screen name, retrieve:

• Offline/online state
• Idle state
• Idle duration
• Away state
• Away message

Use case

This would be useful in the ChivaNet environment for further integration with the ChivaNet website, RAS directory, and presence API. I assume it could be used similarly by other operators.

[jgknight]

Would it be acceptable to add these to the /sessions endpoint? I have a change in-progress that adds the following fields to the /sessions endpoint

• away_message - contents of their away message
• idle_seconds - how many seconds they have been idle
• online_seconds - how many seconds they have been online

Then to address the states,

• For online state you can assume if the screen name is present in /sessions, they are online
• For idle state you can assume if idle_seconds > 0, they are idle
• For away state you can assume if away_message is not blank, they are away

I think it'd also be cool to update the /users endpoint so you could get /user/XXX and see their profile and buddy icon. This would also be a good spot to (in the future) return their privacy settings so you could control whether their presense etc should show up on the chivanet directory page.

[CoherentLogic]

That works for me!