Expand description
Agent ↔ control-plane wire types. LOADBEARING: within a major version,
additions must be backwards-compatible (older consumers serde-ignore unknown
fields); bump PROTOCOL_MAJOR_VERSION for any breaking change.
Phase 8d trimmed the legacy v0.1 checkin / confirm / activate wire shape;
Phase 9a then deleted the legacy /v1/agent/report surface (ReportRequest,
ReportEvent, ReportResponse) — the unified event-driven wire (RFC-0005
§4.2 → runtime/wire.rs + CP’s server/routes/events.rs) is now the
sole agent→CP event channel.
Structs§
- Generation
Ref - Host
Rollout Snapshot - LIFT #3: snapshot of a host’s per-rollout state, carried in the HeartbeatResponse when CP detects the agent’s reducer is empty but CP holds non-terminal records for the host (typical post-restart shape after LIFT #1 synthesizes the state advance). The agent’s boot-recovery handler applies each snapshot to its in-memory HostRolloutState before workers spawn, restoring the cache so probe runners + advance-ticker resume their work post-restart.
- Pending
Generation
Constants§
- PROTOCOL_
MAJOR_ VERSION - Sent in
X-Nixfleet-Protocol; CP rejects mismatched majors with 426. - PROTOCOL_
VERSION_ HEADER