Graphorin API reference v0.7.0
Graphorin API reference / @graphorin/memory / / FactInput
Interface: FactInput
Defined in: packages/memory/src/tiers/semantic-memory.ts:43
Author-time fact payload accepted by SemanticMemory.remember. The framework derives id, kind: 'semantic', userId, createdAt, updatedAt, validFrom, the optional embedder_id, and the deduplication hash from this input.
Stable
Properties
| Property | Modifier | Type | Description | Defined in |
|---|---|---|---|---|
confidence? | readonly | number | - | packages/memory/src/tiers/semantic-memory.ts:49 |
importance? | readonly | number | Importance hint in [0, 1] (X-1 / MCON-12). Feeds the multi-signal salience score that orders decay archiving and capacity eviction - higher importance ⇒ evicted later. Values are clamped to [0, 1]; non-finite values are dropped. The consolidator's extraction pass fills this from the model's per-fact 1-10 rating (normalizeImportance); absent ⇒ the neutral midpoint at scoring time. | packages/memory/src/tiers/semantic-memory.ts:71 |
object? | readonly | string | - | packages/memory/src/tiers/semantic-memory.ts:47 |
owner? | readonly | MemoryOwner | Principal dimension (D3). The consolidator stamps 'agent' on synthesized writes; user-authored writes may pass 'user'. Absent (the default) leaves the column NULL - treated as 'user' at filter time. Never gates default recall. | packages/memory/src/tiers/semantic-memory.ts:78 |
predicate? | readonly | string | - | packages/memory/src/tiers/semantic-memory.ts:46 |
provenance? | readonly | MemoryProvenance | Trust-provenance tag (P1-4). Writers that synthesize memory pass 'extraction' / 'reflection' so the fact lands quarantined; first-party writers pass 'user' / 'tool' (or omit it - absent ⇒ treated as first-party active). The status is derived from this tag plus the injection heuristics; it is never author-set. | packages/memory/src/tiers/semantic-memory.ts:61 |
sensitivity? | readonly | Sensitivity | - | packages/memory/src/tiers/semantic-memory.ts:50 |
subject? | readonly | string | - | packages/memory/src/tiers/semantic-memory.ts:45 |
supersedes? | readonly | string | - | packages/memory/src/tiers/semantic-memory.ts:53 |
tags? | readonly | readonly string[] | - | packages/memory/src/tiers/semantic-memory.ts:48 |
text | readonly | string | - | packages/memory/src/tiers/semantic-memory.ts:44 |
validFrom? | readonly | string | - | packages/memory/src/tiers/semantic-memory.ts:51 |
validTo? | readonly | string | - | packages/memory/src/tiers/semantic-memory.ts:52 |