Reference Documentation
Protocol Tokens
Inter-tool communication uses structured stdout tokens parsed by management applications.
Token Reference
Legacy __VANTAGE_*__ and __SPECTRE_*__ prefixes are parsed by Crucible v2 for backward compatibility but should not be emitted by new code.
| Prefix | Payload | Emitters | Consumer |
|---|---|---|---|
__CRUCIBLE_LOG__: |
JSON: {ts, level, msg, tool, phase} | All Crucible-managed tools (SS3, OSift, Fracture, Siphon, Auger, Trawler, Aether family, Bastion, Forge, Quill, Isotope) | Crucible v2 |
__CRUCIBLE_ERR__: |
JSON: {ts, level, msg, tool, traceback?} | All Crucible-managed tools | Crucible v2 |
__CRUCIBLE_STATUS__: |
JSON: {ts, phase, progress_pct, msg} | All Crucible-managed tools | Crucible v2 |
__CRUCIBLE_PROMPT__: |
JSON: {id, question, options[], default} | All Crucible-managed tools | Crucible v2 |
__CRUCIBLE_FINDING__: |
JSON: full finding object (schema v1.1) | All Crucible-managed tools | Crucible v2 |
__CRUCIBLE_ACTION_ITEM__: |
JSON: {title, priority, detail} | Fracture, Auger | Crucible v2 |
__CRUCIBLE_TARGET__: |
JSON: {ip, hostname, ports[], os?} | Scattershot3, Trawler | Crucible v2 |
__CRUCIBLE_PORT__: |
JSON: {ip, port, proto, service, state} | Scattershot3, Trawler | Crucible v2 |
__GB_LOG__: |
JSON: {ts, level, msg, module} | Gearbox | Gauntlet |
__GB_FINDING__: |
JSON: full finding object | Gearbox | Gauntlet |
__GB_STATUS__: |
JSON: {ts, module, progress_pct, msg} | Gearbox | Gauntlet |
__GB_PROMPT__: |
JSON: {id, question, options[], default} | Gearbox | Gauntlet |
__GB_OBSERVATION__: |
JSON: {ts, module, msg, data} | Gearbox | Gauntlet |