Tokens

Token is the immutable value object for a discrete game entity: a card, piece, item, character, or resource. Its ordinary fields include id, group, label, text, meta, char, kind, and index.

Tokens are created and destroyed; their values are not edited in place. Operations that appear to transform an entity create a new token and retain ancestry through provenance fields. Runtime metadata such as _tags and _attachments is distinct from the core CRDT value and must be handled deliberately when serializing.

Tokens can be members of a Stack, placements in a Space, or entries in a Source. Those containers store token data in the shared Chronicle and use stable entry or placement identities so concurrent ordering changes do not require replacing the entire membership list.

See Provenance for merge and split fields.