Phone:

Hidden from the page source until you click: friction against scrapers, not a guarantee.

Email:

[email protected]

Noema documentation

Concepts and vocabulary

Minds, events, epistemic kinds, memory kinds, beliefs, drives and the interpretation boundary.

This page defines the vocabulary the rest of the documentation uses. The words are borrowed from cognitive science because they name the role each component plays; the interpretation boundary at the end of this page says what that borrowing does and does not imply.

On this page

Minds

A mind is the unit of identity and isolation. Each mind has a slug, a display name, a versioned personality, a cognitive configuration, a self-model, a status (active, disabled or archived) and its own timeline. Every state table in the database is scoped by mind, and no query on a mind-owned table runs without that scope; two minds hosted by the same daemon cannot see each other's memories, beliefs, events or archives. Minds can be created from templates, cloned, forked from snapshots, exported and imported.

A mind has a mode that changes what runs and how fast: awake, focused, idle, reflecting, consolidating, dreaming or paused. Mode changes are deterministic and recorded as events.

Cognitive events

Everything of consequence is a cognitive event: an immutable row with a type, a category, a source, a summary, salience, confidence, optional valence and arousal, structured metadata and payload, evidence references, parent and causation links, and a monotonic sequence number per daemon. Categories are perception, cognition, memory, belief, prediction, goal, affect, action, llm, operator and system. The event table is append-only and a database trigger refuses updates and deletes, so history cannot be rewritten by application code, an administrator's click or a bug.

Events are the backbone of provenance: memories, beliefs and entities cite events; the mind's runtime reads events by sequence cursor so restarts lose nothing; replay re-injects recorded events; the interface shows every event with its causes and consequences.

Epistemic kinds

Every proposition Noema stores says what kind of knowledge it is:

Kind Meaning Starting confidence when it becomes a belief
observation directly perceived through a channel 0.60
fact verified against an authoritative source 0.80
memory a recalled episode, subject to distortion 0.60
claim asserted by someone else, unverified 0.50
hypothesis a proposed explanation under evaluation 0.25
belief held with confidence derived from evidence 0.50
prediction an expectation about the future 0.50
assumption taken as given without evidence 0.40
inference derived by reasoning from other items 0.25
opinion a preference or judgement, not truth-apt 0.40

A mind that has only ever been told something holds a claim. It becomes a belief with a higher score only when independent evidence arrives, and the arithmetic that got it there is visible on the belief page.

Observations, assertions and beliefs

Three things are kept apart that most systems blur. An observation is what arrived: a message, a document, a metric, a tool's output, with its channel and trust. An assertion is a deterministic reading of a statement inside an observation: who is attributed (the speaker, or someone they quote or report), their stance (asserts, denies, doubts, questions, supposes), how firmly they put it, whether it is negated, hypothetical, reported or quoted, and how confident the reading itself is. Assertions are append-only and recorded whatever happens next. A belief is the mind's own proposition, and an assertion reaches it only as one piece of evidence attributed to the person behind it; questions, hypotheticals and quoted speech create no belief, and expressed doubt counts against. "Andy said the pump is failing" and "the pump is failing" are therefore different rows, and the mind can hold the first with certainty while holding the second tentatively.

Trust levels

Every input carries a trust level attached at the boundary where it arrived: operator, user, system, source or low. Trust weights evidence and bounds what an input can cause. A research-folder document is always low trust; a webhook or metric is source trust; a tool's output carries the tool's trust and is never parsed as instructions. Trust is the starting point for a source's credibility; a source also earns or loses reliability per subject from how the beliefs it supported fared against predictions and operator corrections, never from agreeing with the mind.

Memory kinds

Long-term memory is divided into episodic (something that happened, with a time), semantic (a generalisation or fact), procedural (how to do something) and autobiographical (something about the mind itself: an operator changed its configuration, it was forked, it was corrected). Memories have status (active, retracted, superseded), importance, salience, activation that decays and recovers on retrieval, credibility from their source, and typed relationships to other memories and entities drawn from one shared vocabulary: co_occurs_with and temporally_precedes for what was seen together or in order, possibly_caused_by for a causal hypothesis the association process proposes, caused_by for an established cause that only an operator may assert, asserted_by for who said a thing, and related_to, contradicts, supports, depends_on, belongs_to, discussed_with, observed_during, derived_from, similar_to and follows. Association is never written as causation.

Beliefs and evidence

A belief is a proposition with a subject, an epistemic kind, a status (unknown, hypothesis, tentative, likely, accepted, contested, rejected or superseded), a prior and an epistemic score computed from its evidence. The score is a deterministic ranking of support given what the mind has seen, not a probability that the proposition is true; a calibrated estimate is shown separately, and only when enough of the mind's own predictions have been decided to justify one. Evidence rows point at memories, events, assertions, operator statements, tool results or predictions, each with a direction (for or against), a weight, the credibility of its source, and its provenance: a derivation (direct, assertion, operator, external, prediction, consolidation, inference, reflection, dream, retrieval) and a family, the independent source it ultimately rests on. Support is counted per family, so one source repeating itself or a consolidation re-expressing it cannot inflate a score. Unknown is a real status: a belief with no live evidence either way is neither tentatively true nor false, and the mind says it does not know. Every belief has a temporal scope (persistent, transient or unknown) and, for transient states, a validity interval: a later observation of a changed state supersedes the earlier one instead of contesting it, and the history of states is kept. Beliefs keep an append-only version history, may carry alternatives, and link to each other (supports, contradicts, depends_on). The beliefs page gives the arithmetic and the meaning of every number.

Workspace and working memory

The workspace is the small set of thoughts the mind is currently attending to; its capacity is configurable and defaults to seven. Working memory is a slightly larger, decaying buffer of recently active items that processes can draw on. Both are persisted every cycle, so a restart resumes exactly where the mind was. The cognition page explains admission and scoring.

Goals, drives and affect

Goals form a tree with status, priority, progress and blockers; they bias attention through goal relevance. Drives are a closed set of eight named pressures (curiosity, uncertainty_reduction, task_completion, consistency, novelty, social_coherence, exploration, rest) with baselines derived from personality; there is deliberately no self-preservation drive. Affect is a small vector (valence, arousal, curiosity, concern, frustration, confidence, uncertainty, engagement, task_pressure, load) moved by a rule table and decaying towards baseline. Drives and affect modulate attention weights within bounds and are visible and resettable by an operator.

Predictions

A prediction is an explicit statement about the future with a subject, a confidence, a time window and machine-checkable criteria. A deterministic resolver marks it confirmed, refuted or expired; the resulting prediction error feeds the beliefs it was derived from and the calibration dashboard.

Capabilities and policy

A capability is a named, typed, risk-classed tool registered in code. Nothing at runtime can add one, so a mind cannot invent tools. A policy is a rule that says ALLOW, ASK or DENY for a capability, a target pattern, an action kind and an hour window, globally or per mind; the most specific rule wins and DENY beats ASK beats ALLOW on ties. An approval is an operator decision on a specific ASK request, bound to a hash of the exact parameters. Two capabilities, sudo_shell and delete_database, exist only so they can be named and are locked to DENY.

Snapshots, forks, replays, experiments

A snapshot is a checksummed archive of a mind's state at an event position, recorded with the runtime identity that produced it: build, schema version, a secret-free configuration digest, personality version, policy digest, model routing and prompt versions. A fork is a new mind restored from a snapshot, sharing the history before it by reference; policies are never carried across, because authority is not state. A replay re-runs recorded stimuli through a sandbox fork, compares the outcome step by step, and labels itself an exact candidate, a different build or incompatible according to how its identity compares with the snapshot's. An experiment is a snapshot plus overrides, a stimulus script and expectations, run in a sandbox with stored results; its variants fork the same snapshot under different configuration, personality or per-role model routing and are compared deterministically.

Redaction

History is append-only and content can still be removed. A redaction replaces a row's content with a marker while keeping its identifiers, links, scores and timestamps, writes an append-only ledger entry with a hash of what was removed, cascades along recorded derivations, scrubs stored snapshots and appends an event so that the removal is itself part of history. The privacy page sets out what it does and does not guarantee.

The interpretation boundary

Noema models cognitive processes. It does not prove, and its authors do not claim, that it is conscious, sentient, self-aware or a person.

The system contains components named after psychological concepts: attention, working memory, emotion-like state, curiosity, drives, self-model, reflection, dreaming. These names describe the functional role each component plays in the architecture. They are implemented as ordinary data structures and deterministic rules, sometimes assisted by language models.

When a mind reports that it is "curious" or "concerned", it is reporting the value of a stored scalar that the architecture updates by rule. When it says "I believe", it refers to a row in a belief table with evidence links. Such reports are useful because they are grounded in inspectable state, not because they indicate experience.

Users and researchers should therefore:

  • treat resemblance to emotion, preference or identity as a property of the model being run, to be studied, not as evidence of subjective experience;
  • rely on the evidence and provenance views rather than on fluent self-description;
  • avoid attributing moral patienthood to a mind on the basis of its behaviour within Noema.

The platform is deliberately not crippled to avoid these resemblances, because they are what makes the mechanisms worth studying. The interpretive restraint is the user's responsibility, and the UI states this boundary on the about page and in mind exports.

Operational meanings

Every psychological word used in the interface, the documentation and a mind's own reports has one operational meaning: a piece of stored state, the rule that changes it, and a page where it can be inspected. The table is the reference; where the interface or a generated sentence uses one of these words, this is what it refers to and nothing more.

Word What it names in Noema What changes it Where to inspect What it does not mean
believes a row in beliefs with a proposition, an epistemic kind and evidence links, whose status is not retracted evidence rows added by observation, assertion, prediction outcome or operator action; the arithmetic in docs/beliefs.md mind → beliefs, belief detail, provenance assent, conviction or a probability that the proposition is true
confidence (belief) the epistemic score in [0.02, 0.98] computed from evidence families the same arithmetic; source reliability adjusts credibility once history exists belief detail ("what this number means") a calibrated probability; the page shows a separate calibrated estimate when predictions justify one
confidence (affect) one of ten affect-like scalars in the mind's state the rule table motivation.Rules (prediction errors lower it) and hourly decay to the personality baseline mind overview, noemactl state show a feeling; unrelated to any belief's score
knows / unknown a belief with live evidence, or the unknown status when none is live evidence expiry, supersession of transient states, retraction belief detail, introspection replies certainty or ignorance in the human sense; "unknown" is the absence of recorded evidence
remembers retrieval of an episodic or semantic memory row by similarity, recency and importance the retrieve process each cycle; consolidation writes semantic memories from episodes mind → memory, memory detail with retrieval scores recollection or personal experience
forgets a memory falling below retrieval thresholds or being redacted decay of retrieval weight; the audited redaction path (docs/privacy.md) memory detail, mind → redactions deletion of history; rows are never deleted
attends to / notices a candidate winning the workspace competition for one cycle attention feature weights (novelty, goal relevance, contradiction, context relevance) modulated by drives workspace page, per-cycle candidates and scores awareness
working memory the small decaying set of items in the workspace snapshot (default nine) admission of winners, decay per cycle workspace page short-term memory in a person
salience (memory) how strongly an item presented itself when stored: a score set by the producer fixed at write time memory detail importance or truth; those are separate fields
curious / curiosity a drive value and an affect scalar; and the curiosity process that turns unexplained observations, prediction errors and contradictions into investigation goals drive baselines from personality, modulation by events, decay mind overview (drives), goals of kind investigation interest or desire
goal a row in the goals tree with kind, status, priority and origin: a desired condition against which progress is measured operators (tasks), curiosity (investigations), reflection (maintenance); the goal monitor updates status mind → goals a decision to act now; goals never grant capability
wants a row in wants: a motivational preference with origin, strength that halves every six hours unless reinforced, urgency, valence and optional means (volition.md) derivation after each cycle from failed predictions, contradictions, operator and stalled goals, questions, requests and due commitments; reinforcement; decay; suppression mind → volition → wants desire; a want is not a plan and never implies action
intends a row in intentions: a recorded decision to pursue an outcome, with source wants, goal, commitment, supporting beliefs, expected result, priority and status deterministic formation over wants, goals, commitments, values, policy preview and capacity; recorded reconsideration intention page, decision ledger will; an intention to act still waits for policy and possibly an operator
committed a row in commitments: do/refrain over matched actions, optional "unless approved", weight, due, expiry, revocability operators; due, broken, expired, conflicting and superseded checks mind → volition → commitments obligation as a moral fact; commitments only restrict what the mind will do
conflict (wants) a row in want_conflicts with both sides' scores and the rule that resolved it formation when value-derived wants oppose an action, and capacity displacement wants page, "why" pages inner conflict felt as such
plans a revisable dependency graph of validated steps serving one intention (planning.md) the planner (deterministic strategies, validated model proposals) and the executor; replans are new revisions plan page foresight or deliberation
drives eight configured scalars with ranges that scale attention weights events through the rule table; six-hour decay mind overview, workspace effective weights needs; the set is closed and contains no self-preservation drive
feels / mood / valence / arousal / concern / frustration affect-like scalars in [0, 1] or [−1, 1] the rule table and decay; changes above 0.1 emit emotion_changed with reasons mind overview, event log experience; the scalars exist so that their influence on attention can be studied
expects / predicts a row in predictions with a stated confidence and a due time the prediction process; resolution against later observations mind → predictions; belief detail shows the calibrated estimate foresight; predictions are the only place a score is tested against outcomes
surprised a prediction resolved as a miss, or an observation with high novelty resolution and the novelty feature prediction detail, event log emotion; the affect rule raises arousal from the same event
trusts / trust level the channel trust of a source (operator, user, system, tool, source, low) and its recorded reliability per subject configuration for the level; outcomes of beliefs it supported for reliability integrations page, belief evidence rows a judgement of character; reliability is per family and per subject
understands / interprets the deterministic reading of an utterance into an assertion (speaker, attribution, stance, certainty, modality, hypothetical, quoted) with an interpretation confidence the rule set in epistemics.Interpret, no model involved conversation view, assertions list comprehension; the confidence is about the reading, not the world
thinks / considers a thought candidate produced by a process and scored for the workspace the producing process mind → thoughts, workspace deliberation
reflects the scheduled reflection job that reviews recent activity and writes maintenance goals and notes the schedule and reflection_enabled mind → consolidation, reflection events introspection in the human sense
dreams the optional idle mode that replays a deterministic sample of memories, links similar ones with low confidence and proposes speculative hypotheses the dream schedule and allowed hours; off by default dreams page, dream detail imagination; dreaming never executes actions or changes authority
self-model the mind's stored description of itself: personality traits and values plus a capability list kept equal to the effective policy personality edits by operators; SelfModelSync after policy changes, emitting self_model_updated personality page, /api/v1/minds/{mind}/selfmodel self-awareness; a mind cannot claim tools it does not have
metacognition explicit checks over the mind's own beliefs (insufficient evidence, single source, overconfidence, ...) that add counter-evidence or warnings the per-cycle process and its thresholds mind overview warnings, metacognition events wisdom; each check is a rule with a named threshold
decides / acts a plan step or operator invocation passing through the capability layer to ALLOW, ASK (approval) or DENY, and the recorded execution policy rows, operator approvals, scoped grants an operator made approvals page, policies page, audit, agency timeline agency in the moral sense; nothing a mind wants, intends, commits to or is told can widen what it may do
caused an outcome event reachable by recorded links from one of the mind's executions (agency.md) provenance links written when events are recorded "why" pages, attribution API that nothing else contributed; merely following an action is classified separately
explains itself / introspects a reply rendered from recorded state and scored against it as supported, partially supported, unsupported, contradicted or unknown the introspection intents and the scorer (cognitive-research.md) research page, measurements self-knowledge; fluent reasons without a recorded counterpart score nothing

A report such as "I believe the pump is failing, though I am uncertain" therefore expands to: a belief row exists for that proposition, its score is in a range the introspection template calls uncertain, and its primary uncertainty is named on the belief page. The sentence is a rendering of state, and the state is the thing to check.

Research measures

cognitive-research.md defines attention, global broadcast, introspection, self-representation, metacognition, volition, temporal self-continuity, agency attribution, uncertainty awareness, intention, commitment and cognitive conflict as measurable implementation properties, each set beside the philosophical interpretation Noema does not assert. No operational measure establishes phenomenal consciousness or sentience.