Graphorin API reference v0.4.0
Graphorin API reference / @graphorin/memory / / SemanticMemoryStoreExt
Interface: SemanticMemoryStoreExt
Defined in: packages/memory/src/internal/storage-adapter.ts:77
Extension of the typed SemanticMemoryStore with optional embedding-aware helpers + lifecycle helpers that storage adapters may expose.
Stable
Extends
Methods
forget()
forget(id, reason?): Promise<void>;Defined in: packages/core/dist/contracts/memory-store.d.ts:72
Parameters
| Parameter | Type |
|---|---|
id | string |
reason? | string |
Returns
Promise<void>
Inherited from
get()?
optional get(id): Promise<Fact | null>;Defined in: packages/memory/src/internal/storage-adapter.ts:96
Lookup a single fact by id (returns null when absent or soft-deleted).
Parameters
| Parameter | Type |
|---|---|
id | string |
Returns
Promise<Fact | null>
historyOf()?
optional historyOf(scope, factId): Promise<readonly Fact[]>;Defined in: packages/memory/src/internal/storage-adapter.ts:121
Walk the bi-temporal supersede chain that factId belongs to and return every fact in it, oldest → newest (by validFrom), including superseded / soft-deleted rows so callers can answer "how did this fact change over time". Scope-guarded and cycle-safe; returns [] for an unknown id. Powers SemanticMemory.history (P0-2). The default @graphorin/store-sqlite adapter implements it.
Parameters
| Parameter | Type |
|---|---|
scope | SessionScope |
factId | string |
Returns
Promise<readonly Fact[]>
purge()?
optional purge(id, reason?): Promise<void>;Defined in: packages/memory/src/internal/storage-adapter.ts:111
Hard-delete a fact (GDPR path). The audit log row is preserved but the row itself + every per-embedder vec0 entry is removed. Distinct from SemanticMemoryStore.forget (soft-delete).
Parameters
| Parameter | Type |
|---|---|
id | string |
reason? | string |
Returns
Promise<void>
remember()
remember(fact): Promise<void>;Defined in: packages/core/dist/contracts/memory-store.d.ts:69
Parameters
| Parameter | Type |
|---|---|
fact | Fact |
Returns
Promise<void>
Inherited from
rememberWithEmbedding()?
optional rememberWithEmbedding(fact, options): Promise<void>;Defined in: packages/memory/src/internal/storage-adapter.ts:78
Parameters
| Parameter | Type |
|---|---|
fact | Fact |
options | EmbeddedWriteOptions |
Returns
Promise<void>
search()
search(scope, opts): Promise<readonly MemoryHit<Fact>[]>;Defined in: packages/core/dist/contracts/memory-store.d.ts:70
Parameters
| Parameter | Type |
|---|---|
scope | SessionScope |
opts | MemorySearchOptions |
Returns
Promise<readonly MemoryHit<Fact>[]>
Inherited from
searchVector()?
optional searchVector(
scope,
embedding,
embedderId,
topK,
asOf?,
includeQuarantined?): Promise<readonly MemoryHit<Fact>[]>;Defined in: packages/memory/src/internal/storage-adapter.ts:79
Parameters
| Parameter | Type | Description |
|---|---|---|
scope | SessionScope | - |
embedding | Float32Array | - |
embedderId | string | - |
topK | number | - |
asOf? | string | Point-in-time filter applied after KNN: only facts whose validity interval contains asOf (ISO-8601) survive. P0-2. |
includeQuarantined? | boolean | Include quarantined facts in the KNN result (validation / inspector path). Default reads exclude them. P1-4. |
Returns
Promise<readonly MemoryHit<Fact>[]>
setStatus()?
optional setStatus(
factId,
status,
reason?): Promise<void>;Defined in: packages/memory/src/internal/storage-adapter.ts:105
Set a fact's retrieval-trust status and write a memory_history audit row (P1-4). Promotes a quarantined fact to active (the validation path) or re-quarantines an active one. Never touches content / embedding / tombstone — quarantine is a retrieval gate. Powers SemanticMemory.validate; the default @graphorin/store-sqlite adapter implements it.
Parameters
| Parameter | Type |
|---|---|
factId | string |
status | MemoryStatus |
reason? | string |
Returns
Promise<void>
supersede()
supersede(
oldId,
newFact,
reason?): Promise<void>;Defined in: packages/core/dist/contracts/memory-store.d.ts:71
Parameters
| Parameter | Type |
|---|---|
oldId | string |
newFact | Fact |
reason? | string |
Returns
Promise<void>