Skip to content

MindState ​

First-class temporal mental-state record (L5, optional spoke-cognition) — a standalone wire object on the when-axis that records how a holder's mental state changes over time. Required: schema_version, mind_state_id, holder_entry_id, extensions.

When to use ​

Use MindState when the temporal course of a mental state is itself the interchange fact: false-belief structures, dramatic-irony structures, or any "who knows, believes, perceives, wants, or feels what at time t" record. MindState is strictly derivative — the holder KnowledgeEntry's modules.cognition (standard cognition records) and modules.mental (the nine-field mental vocabulary: identity, beliefs, attention, goals, intentions, emotions, dispositions, norms, constraints) carry the authoritative values, and this record presents them over time. modules.mental.beliefs holds derivative summary, count or reference data.

Minimal example ​

json
{
  "schema_version": 1,
  "mind_state_id": "ms_01HXYZ",
  "holder_entry_id": "kb_mira",
  "canonical_name": "Mira — relieved after the Treaty of Ashford",
  "occurred_at": "1421-06-03T12:00:00Z",
  "snapshot": {
    "emotions": [{ "emotion": "relief", "intensity": 0.7 }],
    "goals": [{ "goal": "secure the harbor charter", "status": "active" }]
  },
  "deltas": [
    {
      "path": "/modules/mental/emotions",
      "previous": [{ "emotion": "anxious", "intensity": 0.8 }],
      "next": [{ "emotion": "relief", "intensity": 0.7 }]
    }
  ],
  "extensions": {}
}

Field table ​

FieldTypeNotes
schema_versionSchemaVersionRequired
mind_state_idstring ≥ 1 charStable id, opaque to the protocol
holder_entry_idstring ≥ 1 charThe mental actor's KnowledgeEntry entry_id; the derivative source
canonical_namestring ≥ 1 char, optionalHuman-stable label
occurred_atTimestamp, optionalWhen the mental state held
sort_keystring, optionalOpaque ordering hint within a mental-state timeline
snapshotMentalFieldMap, optionalDerivative full-field snapshot of the holder's mental state at this point
deltasMindDelta[], optionalDerivative field-level change records since the prior mental state
cognitionCognitionProjection, optionalDerivative projection of the selected holder-side cognition authority, with all retained matching assessments and the current-view trace
source_anchorSourceAnchor, optionalManuscript or scene anchor
created_at / updated_atTimestamp, optional
extensionsExtensionMapRequired

Every MindDelta.path is an RFC 6901 JSON Pointer rooted at /modules/mental/<field> (any of the nine fields), /modules/cognition/records/... or /modules/cognition/world_facts/.... Deltas are presentation only.

Capability: spoke-cognition ​

spoke-cognition is one optional capability flag, with no subflags. On this surface a host implements the MindState temporal record, modules.cognition on the holder KnowledgeEntry, modules.observation on TimelineEvent.modules, and Scope.cognition selection with attribution-preserving projection. A host that also serves Memory implements recorded-at-time Content.cognition validation and the cognition_filter reads. Advertisement covers only the surfaces a host actually serves, and the manifest string alone is not conformance evidence; negotiation reuses the signed-hello intersection, and an unsupported requirement rejects the whole request with details.reason: "unsupported_cognition_requirement". Mental-state engines (belief revision, ToM inference, observation rendering) are product-owned. See Protocol reference — Cognition negotiation and rejection.

Derivative cognition projection ​

MindState.cognition carries a CognitionProjection of the selected holder-side records. A current projection carries, per assessed item, the identified selection policy and the traced input/selected record ids; a recorded_at projection carries the historical records without a current selection. Every item keeps its own assessment_context, all retained matching assessments remain in assessments, and disagreements are preserved rather than averaged. An assessed item appears only for records the filter matched. A no_record item is not a matching record: it appears only when the filter exactly addresses holder, complete target identity, assessment_context.context_id and an explicit fork predicate, and the authorized source holds no record for that compound key in the selection's view before optional predicates — an omitted fork is a wildcard, and an ordinary empty result is items: [] (data model §Selection and projection). Event modules.observation says who could perceive; a PerceptionRecord says what a holder actually captured.

Field tables and handbook ​

Field-level detail lives on the reference and spec surfaces:

  • Data model reference — the durable objects, including TimelineEvent (when-axis), CognitionRecord and the MindState / ontology-label distinction.
  • Protocol reference — capability flags, negotiation and rejection.
  • Concepts — layers and dual-concern pairs.