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

CapabilityBehavior
log-levels-v1Debug, info, warn, and error log telemetry
expression-ast-v1Broker-compiled safe expressions
frame-locals-v1Optional bounded variables for selected stack frames
safety-report-v1Normalized 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.