Memory & Reflection

Handles the storage, search, and analysis of past conversations and personal notes.

featureSearchable Relationship MemoryfeatureVoice-Based Interaction

Data Model

Diagram

er Memory & Reflection data model

Gallery Source ⛶

Diagram Syntax Error

erDiagram
  note {
    string id PK
    string targetId 
    string targetType 
    string content 
    string visibility 
    datetime createdAt 
  }
  insight {
    string id PK
    string sessionId 
    string type 
    string description 
    datetime generatedAt 
  }

Source

Table note {
  id string [pk]
  targetId string [note: 'markerId or transcriptSegmentId']
  targetType string [note: 'marker | transcript-segment']
  content string
  visibility string [note: 'private | shared']
  createdAt datetime
}

Table insight {
  id string [pk]
  sessionId string [note: 'Links to conversation/session']
  type string [note: 'recurring-theme | contradiction | unmet-need']
  description string
  generatedAt datetime
}

API

Actions

search-memory

Searches transcripts and notes for a text query.

Properties

querystring

Parameter	Type	Required	Description
query	string	—

add-note

Attaches a personal reflection to a marker or transcript segment.

Properties

marker-idstringcontentstringvisibilitystring

Parameter	Type	Required	Description
marker-id	string	—
content	string	—
visibility	string	—	'private' or 'shared'

update-privacy

Updates the visibility of a specific note, transcript, or marker.

Properties

target-idstringvisibilitystring

Parameter	Type	Required	Description
target-id	string	—
visibility	string	—

query-ai

Processes a voice query against the relationship memory.

Properties

voice-querystring

Parameter	Type	Required	Description
voice-query	string	—

Events

insight-generated

Properties

session-idstringtypestringdescriptionstring

Parameter	Type	Required	Description
session-id	string	—
type	string	—
description	string	—

privacy-updated

Properties

target-idstringvisibilitystring

Parameter	Type	Required	Description
target-id	string	—
visibility	string	—

Operations

read

detect-patterns

Analyzes a transcript to identify recurring themes, contradictions, or unmet needs.

Input Parameters

transcriptobject

Parameter	Type	Required	Description
transcript	object	—

Errors

Error ID	Code	Category	Description
pattern-detection-failed	TODO	domain	Thrown when the local AI model fails to process a transcript.

Reactive Topology

autoflow Memory & Reflection reactive topology

Gallery Source ⛶

Diagram Syntax Error

flowchart LR;
    classDef actionNode fill:#e3f2fd,stroke:#1e88e5,color:#0d47a1;
    classDef eventNode fill:#e8f5e9,stroke:#4caf50,color:#1b5e20;
    classDef errorNode fill:#ffebee,stroke:#ef5350,color:#b71c1c;
    classDef externalNode fill:#f5f5f5,stroke:#9e9e9e,color:#616161,stroke-dasharray:4 4;
    subgraph memory-reflection ["Memory & Reflection"]
        n0(["search-memory"])
        n1(["add-note"])
        n2(["update-privacy"])
        n3(["query-ai"])
        n4{{"insight-generated"}}
        n5{{"privacy-updated"}}
        n6{{"pattern-detection-failed"}}
    end
    n1 -- success --> n5
    class n0,n1,n2,n3 actionNode;
    class n4,n5 eventNode;
    class n6 errorNode;
    click n0 href "/domains/memory-reflection#search-memory" _self;
    click n1 href "/domains/memory-reflection#add-note" _self;
    click n2 href "/domains/memory-reflection#update-privacy" _self;
    click n3 href "/domains/memory-reflection#query-ai" _self;
    click n4 href "/domains/memory-reflection#insight-generated" _self;
    click n5 href "/domains/memory-reflection#privacy-updated" _self;
    click n6 href "/domains/memory-reflection#pattern-detection-failed" _self;