API Improvement Plan

[bearbin]

ATM the API is quite nice, but there are some areas that are hugely weak/bad.

We need a plan to direct effort to those areas.

Here are the areas I think we should focus on:

• Threading problems - plugins should not know about threading, they should assume that everything works.
  
• API Consistency - Everything behaves differently and so lots of knowledge is needed.
  
• Direct access to the protocol is quite an important feature for special effects.