A kvcs channel head record. Holds the human-readable channel name and the hex patch ids that are currently the tips of the channel.
Record Key
any
Any valid record key
Properties
heads
array
of
string
Required
Hex patch ids that are tips of this channel. The 64-item cap is a defensive bound; real-world channels typically have 1-3 tips.
maxLength: 64 itemsname
string
Required
Channel name (e.g. "main"). Capped at 256 chars — kvcs channel labels are short, human-readable identifiers similar to git branch names.
maxLength: 256 bytesView raw schema
{
"key": "any",
"type": "record",
"record": {
"type": "object",
"required": [
"name",
"heads"
],
"properties": {
"name": {
"type": "string",
"maxLength": 256,
"description": "Channel name (e.g. \"main\"). Capped at 256 chars — kvcs channel labels are short, human-readable identifiers similar to git branch names."
},
"heads": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"description": "Lower-case hex multihash (BLAKE3) of a patch — 128 chars covers the longest hashes in current use."
},
"maxLength": 64,
"description": "Hex patch ids that are tips of this channel. The 64-item cap is a defensive bound; real-world channels typically have 1-3 tips."
}
}
},
"description": "A kvcs channel head record. Holds the human-readable channel name and the hex patch ids that are currently the tips of the channel."
}