Files
noema/docs/conversation.md
T
Andy Dixon 777e8f50b5 feat: add conversation with grounded replies, sample mind and M1 acceptance test
Phase 8, completing milestone M1. A user message is stored and appended
as an observation event carrying trust, actor, channel and reference. The
perceive process analyses it deterministically (intent, introspection
kind, entities, claims, urgency) and, within the per-cycle model
allowance, enriches it through the perceive prompt. Its handler writes a
perception event, an episodic memory with participants, turns claims into
beliefs whose evidence is the message, and builds a response intent from
state: beliefs and memories for the topic, evidence rows for why-questions,
the uncertain band, contested beliefs and their links, recent learning,
status changes, and honest declines for subsystems that do not exist yet
or for requests with no capabilities. The respond prompt phrases the
intent when a model is assigned; otherwise the reply is a direct
rendering of the intent. response_generated cites the message, the
perception, every belief and memory used, the episode and the model call.

API: conversations, messages with optional wait, one-shot ask; chat UI
with live refresh and a per-reply intent view. Sample mind Dani as a
strictly decoded seed document with an import endpoint and noemactl mind
import. tests/m1 drives all fourteen milestone steps including restart.
2026-06-25 19:19:24 +01:00

2.7 KiB
Raw Blame History

Conversation

A message to a mind is never forwarded to a model. It goes through the cognitive cycle (spec §38):

message ──▶ observation event (trust: user/operator, channel, actor, reference)
        ──▶ perceive process: deterministic analysis (intent, entities, claims, urgency),
            optionally enriched by the perceive prompt → "perceive" candidate
        ──▶ attention competition (with recall and association candidates)
        ──▶ perceive handler: perception event, episodic memory, claims → beliefs,
            response intent built from beliefs and memories, reply wording,
            response_generated event citing everything used
        ──▶ message row (role: mind) linked to the event, the intent and the model call

Intents

The deterministic analyser classifies each message as question, statement, request, correction, greeting or introspection. Introspective questions are answered from state, not invented:

Question Source of the answer
What are you thinking about? workspace and working memory
What do you believe about X? belief search plus memory retrieval for X
Why do you believe that? the evidence rows of the best-matching belief
What are you uncertain about? beliefs in the 0.3–0.7 band or contested
Which beliefs contradict each other? contested beliefs and their contradiction links
What did you learn this week? memory and belief creation events in the last seven days
What have you changed your mind about? beliefs whose status changed, with the recorded reason
predictions / curiosity / surprise / patterns declined honestly until those subsystems exist

Statements and corrections become claims: beliefs with the message as evidence (weight by certainty, credibility by trust). Contradictions with existing beliefs are detected and reported in the reply. Requests are declined while the mind has no capabilities, citing the self-model.

Wording

If a model is assigned to the respond role and the per-cycle budget allows, the respond prompt receives the personality brief, the intent, the cited beliefs and memories, the uncertainty note and the self-model limits, with the user message in a data block. Otherwise the reply is a direct, plain rendering of the intent with confidences shown and a note that no model was used. Either way the stored intent lets an operator check that the words match the evidence.

Provenance

The response_generated event cites the observation, the perception, every belief and memory used, the episode written, and the model call. The chat page shows "why this reply" under each answer and links each turn to its event.