Architecture

TrueNorth's engine runs every user message through a 13-stage pipeline. Each stage is isolated, testable, and observable. Click any stage to see the full specification.

Click any stage to see the full specification

Data flow through one turn

Every user message enters the pipeline as a raw string and exits as a structured session update. All 13 stages complete before the response is sent.

yaml/pipeline-flow.yaml
input:
  message: "I'm Priya, I'm 28 years old"
  session_id: "sess_abc123"
  turn: 3
pipeline:
  - stage: language_detection
    output: { locale: "en", confidence: 0.99 }
  - stage: emotion_detection
    output: { valence: 0.6, arousal: 0.3 }
  - stage: pii_detection
    output: { masked: false, pii_found: [] }
  - stage: field_extraction
    output:
      extracted:
        name: "Priya"
        age: 28
      unextracted: [goal, height, weight]
  - stage: hallucination_firewall
    output:
      claims_verified: ["user stated name=Priya in turn 3"]
      claims_blocked: []
  - stage: output_generation
    output:
      message: "Thanks Priya! What's your primary fitness goal?"
      fields_remaining: 6
session_update:
  name: { value: "Priya", confidence: 0.98, source_turn: 3 }
  age:  { value: 28,      confidence: 0.97, source_turn: 3 }
← PreviousQuickstart