Graphorin API reference v0.4.0

---

Graphorin API reference / @graphorin/core / / Fact

Interface: Fact

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

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:90
confidence?	readonly	number	-	-	-	packages/core/src/types/memory.ts:142
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
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:150
kind	readonly	"semantic"	-	MemoryRecord.kind	-	packages/core/src/types/memory.ts:124
object?	readonly	string	Object entity of the s/p/o triple (P2-1). See Fact.subject.	-	-	packages/core/src/types/memory.ts:141
predicate?	readonly	string	Relation label of the Fact.subject→Fact.object triple (P2-1).	-	-	packages/core/src/types/memory.ts:139
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:163
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). Defaults to active; derived / injection-flagged writes land quarantined and are excluded from default recall.	-	-	packages/core/src/types/memory.ts:169
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:137
supersededBy?	readonly	string	ID of the fact that supersedes this one, if any.	-	-	packages/core/src/types/memory.ts:158
supersedes?	readonly	string	ID of the fact this one supersedes, if any.	-	-	packages/core/src/types/memory.ts:156
tags?	readonly	readonly string[]	-	-	MemoryRecord.tags	packages/core/src/types/memory.ts:100
text	readonly	string	-	-	-	packages/core/src/types/memory.ts:125
updatedAt?	readonly	string	-	-	MemoryRecord.updatedAt	packages/core/src/types/memory.ts:94
userId	readonly	string	-	-	MemoryRecord.userId	packages/core/src/types/memory.ts:89
validFrom?	readonly	string	Bi-temporal: when the fact became true, ISO-8601.	-	-	packages/core/src/types/memory.ts:152
validTo?	readonly	string	Bi-temporal: when the fact stopped being true, ISO-8601.	-	-	packages/core/src/types/memory.ts:154