Reference
Protocol and compatibility
Versioning, capability negotiation, commit metadata, event contracts, and links to the canonical protocol.
Protocol version
LiveProbe 0.3.0 implements protocol v1. JSON fields use camelCase on HTTP and tool inputs use snake_case at the MCP boundary. Consumers ignore unknown response fields; producers do not emit undocumented v1 request fields.
Capability negotiation
| Capability | Behavior |
|---|---|
log-levels-v1 | Debug, info, warn, and error log telemetry |
expression-ast-v1 | Broker-compiled safe expressions |
frame-locals-v1 | Optional bounded variables for selected stack frames |
safety-report-v1 | Normalized limits and reason codes |
For multiple active replicas, the broker exposes the intersection of capabilities reported within the 45-second activity window. This prevents a probe from depending on a feature missing from one replica.
Event types
Runtime agents emit snapshot, log, counter, metric, and status events. Heartbeats may contain no events. Successful ingest returns HTTP 202 with the accepted count.
Canonical source
The repository's protocol specification is the canonical broker, MCP, and runtime contract. Package READMEs provide language-specific startup examples.