Make swagger output raw schema valid against openapi v3 spec
The JSON output from https://nucleus.noc.ac.uk/soar/protocol/latest/soar_protocol.json doesn't actually validate against the openapi v3 spec.
It's a minor thing but this output contains and empty definitions: {} object which isn't part of the openapi v3 spec and causes the validation of the specification itself to fail.
This means if we wire up the adapter protocol class to load the schema from here rather than from the committed file in gitlab we may have issues validating messages. It might be that validating messages with the invalid schema is fine and it's just validating the schema itself that fails.
There's a bug in flasgger which has been fixed but the fix has not been released.
The last release of flasgger was Aug 2020 This bug was fixed in Nov 2021 The latest pre-release version is from May 2023 Until the fix gets released we have to remove the invalid definitions object from the spec.
We could potentially just move to the pre-release beta version.