Graphorin API reference v0.7.0

---

Graphorin API reference / @graphorin/core / / Fact

Interface: Fact

Defined in: packages/core/src/types/memory.ts:138

Single semantic-memory fact: an atomic statement about the user / world.

Stable

Extends

• MemoryRecord

Properties

Property	Modifier	Type	Description	Overrides	Inherited from	Defined in
agentId?	readonly	string	-	-	MemoryRecord.agentId	packages/core/src/types/memory.ts:105
confidence?	readonly	number	-	-	-	packages/core/src/types/memory.ts:157
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
importance?	readonly	number	Optional salience hint in [0, 1] for multi-signal forgetting (X-1). A soft signal - higher importance slows a fact's decay and delays capacity-bounded eviction, but never gates recall and never forces retention. Absent on rows written before the feature (treated as neutral, 0.5).	-	-	packages/core/src/types/memory.ts:165
kind	readonly	"semantic"	-	MemoryRecord.kind	-	packages/core/src/types/memory.ts:139
object?	readonly	string	Object entity of the s/p/o triple (P2-1). See Fact.subject.	-	-	packages/core/src/types/memory.ts:156
owner?	readonly	MemoryOwner	Principal dimension (D3). 'agent' on consolidator-synthesized facts; absent ⇒ treated as 'user' at filter time. Never gates default recall - only an explicit owner search filter reads it.	-	-	packages/core/src/types/memory.ts:190
predicate?	readonly	string	Relation label of the Fact.subject→Fact.object triple (P2-1).	-	-	packages/core/src/types/memory.ts:154
provenance?	readonly	MemoryProvenance	Trust-provenance tag (P1-4). Absent on rows written before the feature; treated as first-party (active) when missing.	-	-	packages/core/src/types/memory.ts:178
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). Defaults to active; derived / injection-flagged writes land quarantined and are excluded from default recall.	-	-	packages/core/src/types/memory.ts:184
subject?	readonly	string	Structured (subject, predicate, object) triple for the in-SQLite relation graph (P2-1). The consolidator's extraction prompt emits these; first-party remember({ text }) writes usually omit them. subject/object are the graph entities (resolved to canonical ids in fact_entities); predicate is the relation label and is not itself an entity. Absent on rows written before the feature, and on plain free-text facts - they are a soft enrichment that powers one-hop expansion (MemorySearchOptions has no field; the memory tier's search opts in), never a recall gate.	-	-	packages/core/src/types/memory.ts:152
supersededBy?	readonly	string	ID of the fact that supersedes this one, if any.	-	-	packages/core/src/types/memory.ts:173
supersedes?	readonly	string	ID of the fact this one supersedes, if any.	-	-	packages/core/src/types/memory.ts:171
tags?	readonly	readonly string[]	-	-	MemoryRecord.tags	packages/core/src/types/memory.ts:115
text	readonly	string	-	-	-	packages/core/src/types/memory.ts:140
updatedAt?	readonly	string	-	-	MemoryRecord.updatedAt	packages/core/src/types/memory.ts:109
userId	readonly	string	-	-	MemoryRecord.userId	packages/core/src/types/memory.ts:104
validFrom?	readonly	string	Bi-temporal: when the fact became true, ISO-8601.	-	-	packages/core/src/types/memory.ts:167
validTo?	readonly	string	Bi-temporal: when the fact stopped being true, ISO-8601.	-	-	packages/core/src/types/memory.ts:169