Graphorin API reference v0.7.0
Graphorin API reference / @graphorin/core / / Insight
Interface: Insight
Defined in: packages/core/src/types/memory.ts:292
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.
Core defines only the record shape; the storage surface for insights is NOT part of the baseline MemoryStore contract - it lives in the optional InsightMemoryStoreExt exported from @graphorin/memory (W-048). Adapters without it simply have no insight tier.
Stable
Extends
Properties
| Property | Modifier | Type | Description | Overrides | Inherited from | Defined in |
|---|---|---|---|---|---|---|
agentId? | readonly | string | - | - | MemoryRecord.agentId | packages/core/src/types/memory.ts:105 |
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:301 |
createdAt | readonly | string | - | - | MemoryRecord.createdAt | packages/core/src/types/memory.ts:108 |
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:114 |
id | readonly | string | - | - | MemoryRecord.id | packages/core/src/types/memory.ts:102 |
kind | readonly | "insight" | - | MemoryRecord.kind | - | packages/core/src/types/memory.ts:293 |
owner? | readonly | MemoryOwner | Principal dimension (D3). Reflection-synthesized insights are 'agent'. | - | - | packages/core/src/types/memory.ts:319 |
provenance? | readonly | MemoryProvenance | Trust-provenance tag (P1-4). Reflection-synthesized insights are 'reflection'. See MemoryProvenance. | - | - | packages/core/src/types/memory.ts:312 |
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:307 |
sensitivity | readonly | Sensitivity | - | - | MemoryRecord.sensitivity | packages/core/src/types/memory.ts:107 |
sessionId? | readonly | string | - | - | MemoryRecord.sessionId | packages/core/src/types/memory.ts:106 |
status? | readonly | MemoryStatus | Retrieval-trust state (P1-4). Insights land 'quarantined'. See MemoryStatus. | - | - | packages/core/src/types/memory.ts:317 |
tags? | readonly | readonly string[] | - | - | MemoryRecord.tags | packages/core/src/types/memory.ts:115 |
text | readonly | string | The synthesized higher-order observation. | - | - | packages/core/src/types/memory.ts:295 |
updatedAt? | readonly | string | - | - | MemoryRecord.updatedAt | packages/core/src/types/memory.ts:109 |
userId | readonly | string | - | - | MemoryRecord.userId | packages/core/src/types/memory.ts:104 |