Skip to main content

Module model

Module model 

Source
Expand description

Wire-level types for the cellos-server HTTP API.

These mirror the projector’s response shape. cellctl is a thin client — these types exist only to deserialize responses and re-serialize for --output json. No client-side derivations, no state caching.

Fields are flexible (#[serde(default)]) so that adding fields server-side does not break older clients. This is the same compatibility contract kubectl has with the kube-apiserver.

Structs§

Cell
Cell view returned by GET /v1/cells / GET /v1/cells/<id>.
CellsSnapshot
Snapshot envelope for GET /v1/cells. Mirror of FormationsSnapshot — see that type’s docs for the rationale behind splitting the unified List<T> into endpoint-specific snapshots (MED-CTL-001-A). The canonical key on the wire is cells; the deserializer also accepts a bare array and the legacy generic {items, cursor?} wrapper, but rejects mixed envelopes that contain more than one recognised list key.
CloudEvent
CloudEvent envelope — projector emits these on the stream and on GET /v1/cells/<id>/events plus the /ws/events socket.
Formation
Formation view returned by GET /v1/formations / GET /v1/formations/<id>.
FormationsSnapshot
Snapshot envelope for GET /v1/formations.