Skip to content

Six Primitives

Reference table for the six fixed protocol primitives. Authoritative contract: .nimi/spec/platform/protocol.md and rule family P-PROTO-*.

The Six

PrimitiveRuleCarries
TimeflowP-PROTO-100Progression, timing, temporal meaning
SocialP-PROTO-101Relationships, social graph semantics
EconomyP-PROTO-102Value, exchange, economic state
TransitP-PROTO-103Movement between worlds or contexts
ContextP-PROTO-104Shared situational meaning
PresenceP-PROTO-105Who or what is present, and under what conditions

Each primitive is a contract surface. Worlds may define their own internal rules; meaning that crosses worlds must fit one of these six contracts.

Authority

LayerRole
Platform protocolDefines the primitives' shape and version policy
RealmOwns the source of truth and semantic execution for the six primitives
AppsConsume and observe; do not execute

The P-PROTO-003 rule pins primitive semantic execution and truth source to Realm.

Cross-Consistency

A world transition that involves multiple primitives must satisfy all relevant primitive contracts simultaneously:

ConstraintWhy
A transit must satisfy Social + Economy + Context simultaneouslyTransit moves a participant across worlds; social standing, economic standing, and contextual meaning must all align
Presence cannot bypass social admissionBeing "present" in a world requires social admission first
Timeflow cannot break economy settlement windowsTime progression must respect economic settlement boundaries

The six primitives are not independent enums. They are mutually constraining.

Versioning Posture

PropertyValue
Strategystrict-only
Cross-minor handshakesForbidden
Backward compatibility shimsForbidden
Failure modeFail-close on contract violation

Clients must match. There is no graceful degradation pretending compatibility while violating contracts.

Authorization Presets

Apps interact with primitives under scoped authorization. The platform admits three preset templates that all share the same token shape and validation chain:

PresetReadWriteDelegate
readOnlyyesnono
fullyesyesno
delegateyesyesone level

delegate allows up to one level of further delegation by default.

App Modes

ModePrimitive readPrimitive writeActive count per world
render-appyesnomany
extension-appyesyesat most one active per world

Audit Events

Cross-primitive actions emit audit events recorded under the platform audit dictionary (.nimi/spec/platform/kernel/tables/audit-events.yaml).

Source Basis

Nimi AI open world platform documentation.