Graphorin API reference v0.4.0
Graphorin API reference / @graphorin/core / / Insight
Interface: Insight
Defined in: packages/core/src/types/memory.ts:254
Insight — a higher-order observation the consolidator's reflection pass (P1-1) synthesizes over recent memories ("the user has cancelled three evening plans this month — they may be overcommitted"). No single turn states it; it is inferred, so it is always provenance: 'reflection' and lands status: 'quarantined' (P1-4), excluded from action-driving recall until validated.
Every insight carries mandatory citations (cites) — the ids of the supporting memories it was synthesized from — so a reader can trace it back to evidence; this is the "trustworthy reflection" mitigation against confirmation-bias loops. Insights are managed with an ExpeL-style salience counter (new insights start at 2, pruned at ≤ 0) and are retrieval-ranked below the primary facts they cite.
Stable
Extends
Properties
| Property | Modifier | Type | Description | Overrides | Inherited from | Defined in |
|---|---|---|---|---|---|---|
agentId? | readonly | string | - | - | MemoryRecord.agentId | packages/core/src/types/memory.ts:90 |
cites | readonly | readonly string[] | IDs of the supporting memories (facts / episodes) this insight was synthesized from. Always ≥ 1 — citations are mandatory; an insight with no traceable evidence is never persisted. | - | - | packages/core/src/types/memory.ts:263 |
createdAt | readonly | string | - | - | MemoryRecord.createdAt | packages/core/src/types/memory.ts:93 |
deletedAt? | readonly | string | Soft-delete tombstone. Append-only stores set this instead of removing rows, so prior history is preserved per principle 8. | - | MemoryRecord.deletedAt | packages/core/src/types/memory.ts:99 |
id | readonly | string | - | - | MemoryRecord.id | packages/core/src/types/memory.ts:87 |
kind | readonly | "insight" | - | MemoryRecord.kind | - | packages/core/src/types/memory.ts:255 |
provenance? | readonly | MemoryProvenance | Trust-provenance tag (P1-4). Reflection-synthesized insights are 'reflection'. See MemoryProvenance. | - | - | packages/core/src/types/memory.ts:274 |
salience | readonly | number | ExpeL-style salience counter. New insights start at 2; a maintenance pass up-/down-votes on subsequent corroboration / contradiction and prunes (soft-deletes) insights at ≤ 0. | - | - | packages/core/src/types/memory.ts:269 |
sensitivity | readonly | Sensitivity | - | - | MemoryRecord.sensitivity | packages/core/src/types/memory.ts:92 |
sessionId? | readonly | string | - | - | MemoryRecord.sessionId | packages/core/src/types/memory.ts:91 |
status? | readonly | MemoryStatus | Retrieval-trust state (P1-4). Insights land 'quarantined'. See MemoryStatus. | - | - | packages/core/src/types/memory.ts:279 |
tags? | readonly | readonly string[] | - | - | MemoryRecord.tags | packages/core/src/types/memory.ts:100 |
text | readonly | string | The synthesized higher-order observation. | - | - | packages/core/src/types/memory.ts:257 |
updatedAt? | readonly | string | - | - | MemoryRecord.updatedAt | packages/core/src/types/memory.ts:94 |
userId | readonly | string | - | - | MemoryRecord.userId | packages/core/src/types/memory.ts:89 |