Protocol messages
KiCI tiers communicate over WebSocket using Zod-validated message envelopes. The complete message reference is split across three pages.
| Page | Covers |
|---|---|
| Overview | Message flow, common envelopes, authentication. |
| Orchestrator ↔ Agent | Job dispatch, cancel, registration, log streaming, job / step status, heartbeats, cache upload, provenance attestation upload, event emit, fleet log collection, step approval, execution status forwarding. |
| Dashboard, metrics & wire format | Concurrency events, agent metrics, agent authentication, agent private API, join, peer-to-peer, test-run, observer, wire format, validation, and request tracing. |
See also
Section titled “See also”- Webhook delivery flow — end-to-end trace of a webhook through all three tiers
- Architecture overview — high-level three-tier architecture
- Orchestrator configuration — orchestrator deployment settings
- Agent configuration — agent deployment settings