Skip to content

World Fields

Reference for the World concept: what a world is at the field and contract level.

What A World Is

PropertyDescription
IdentityA unique world id; sortable; non-recyclable
AuthoringCreated by an admitted world creator
PersistenceLong-lived; world state survives session boundaries; world history is append-only
ComposabilityInteroperable with other worlds via the six platform primitives
AuthorityRealm owns canonical world truth, world state, and world history

A world is not a level, a chat room, a campaign, or an app session. A world keeps evolving even when no participants are present.

ConceptWhat it answersOwner contract
TruthWhat is canonically true in this world, regardless of when it was writtenrealm/kernel/truth-contract.md (R-TRUTH-*)
World StateWhat the world looks like right nowrealm/kernel/world-state-contract.md (R-WSTATE-*)
World HistoryHow the world reached its current staterealm/kernel/world-history-contract.md (R-WHIST-*)

These three are not interchangeable. A surface that conflates them silently loses information.

Adjacent Realm Surfaces Owned As World Truth

SurfaceContractRule prefix
Chatrealm/kernel/chat-contract.mdR-CHAT-*
Socialrealm/kernel/social-contract.mdR-SOC-*
Economyrealm/kernel/economy-contract.mdR-ECON-*
Assetrealm/kernel/asset-contract.mdR-ASSET-*
Transitrealm/kernel/transit-contract.mdR-TRANSIT-*
Bindingrealm/kernel/binding-contract.mdR-BIND-*
Resourcerealm/kernel/resource-contract.mdR-RSRC-*
Bundlerealm/kernel/bundle-contract.mdR-BNDL-*

OASIS

PropertyValue
StatusThe unique system main world; formally part of canonical truth
OwnershipCannot be owned by any creator
ReplaceabilityCannot be replaced by an app convention
RoleDefault return point and sole transit hub between worlds

App-World Binding

A world can bind to at most one active extension-app at a time. Other apps may consume world data in render-only mode.

StateMeaning
(new)World exists but no app is bound
activeOne extension-app is bound and writing
suspendedBinding is paused; rebinding requires explicit re-admission
revokedBinding is removed; world becomes available for new binding

Re-binding requires revoking first; binding is not silently transferred.

App Modes

ModeReadWriteConcurrent count per world
render-appyesnomany
extension-appyesyesat most one active

Six-Primitive Cross-Consistency

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

  • A transit must satisfy Social + Economy + Context simultaneously.
  • Presence can't bypass social admission.
  • Timeflow cannot break economy settlement windows.

The six primitives are not independent enums; they are mutually constraining.

World Evolution Engine (Runtime-Owned)

When a world runs inside Runtime (Runtime-hosted world experiences), the World Evolution Engine governs its evolution. WEE has its own execution stage taxonomy distinct from Workflow:

INGRESS → NORMALIZE → SCHEDULE → DISPATCH → TRANSITION → EFFECT → COMMIT_REQUEST → CHECKPOINT → TERMINAL

Replay is recorded-only: WEE V1 replays from recorded events, checkpoints, and commit-request outcomes. There is no re-inference and no fresh route selection during replay.

FieldOwner
WEE event semanticsruntime/kernel/world-evolution-engine-contract.md (K-WEV-*)
Workflow partial-reuse hardcutruntime/kernel/world-evolution-engine-contract.md

Source Basis

Nimi AI open world platform documentation.