Please provide an API for enabling or disabling kOS from another mod

[jwvanderbeck]

As discussed with @erendrake in IRC, we would like to request an API that allows a mod to enable or disable kOS with an optional message to the user as to why.

[erendrake]

If we are building an API for core suppression i would think it should be able to do the following.

• Suppress a kOS Processor with a message
• Release a kOS Processor with a message
• Suppress all kOS Processors on a vessel with a message
• Release all kOS Processors on a vessel with a message

Maybe:

• Run a command on a kOS Processor (eg 'run foobar.ks')
• Return a status for a kOS Processor (eg, ready, running, starved, suppressed, off)
• Kill the script running on a kOS processor

[Dunbaratu]

I think we should peek at the stack trace to identify which other mod the method call came from, and make that part of the message. "kOS is being suppressed by _. for reason:: ____". (The first blank we fill in by examining the stack trace, and the second is the message we were passed by the other mod).

For these, I think the method we provide should be in two different places::

• Suppress a kOS Processor with a message
  • I think this should be a method of our PartModule kOSProcessor.
• Release a kOS Processor with a message
  • I think this should be a method of our PartModule kOSProcessor.
• Suppress all kOS Processors on a vessel with a message
  • I think this needs a global object (like BootStrapper) to be where the method is. I would not use the toolbar window because we don't want that to exist in every single scene..
• Release all kOS Processors on a vessel with a message
  • I think this needs a global object (like BootStrapper) to be where the method is. I would not use the toolbar window because we don't want that to exist in every single scene..