Graphorin API reference v0.7.0
Graphorin API reference / @graphorin/memory / / EpisodicMemoryStoreExt
Interface: EpisodicMemoryStoreExt
Defined in: packages/memory/src/internal/storage-adapter.ts:56
Extension of the typed EpisodicMemoryStore with optional embedding-aware helpers + lifecycle helpers that storage adapters may expose.
Stable
Extends
Methods
archive()?
optional archive(
id,
reason?,
scope?): Promise<void>;Defined in: packages/memory/src/internal/storage-adapter.ts:72
Mark an episode archived. Soft-archive - the row stays for replay. W-154: with scope, adapters no-op unless the row belongs to it.
Parameters
| Parameter | Type |
|---|---|
id | string |
reason? | string |
scope? | SessionScope |
Returns
Promise<void>
count()?
optional count(scope): Promise<number>;Defined in: packages/memory/src/internal/storage-adapter.ts:99
Count the recall-eligible episodes for the scope (CE-5) - a COUNT(*), never materialising rows. Powers honest metadata() counts.
Parameters
| Parameter | Type |
|---|---|
scope | SessionScope |
Returns
Promise<number>
get()
get(id): Promise<Episode | null>;Defined in: packages/core/dist/contracts/memory-store.d.ts
Parameters
| Parameter | Type |
|---|---|
id | string |
Returns
Promise<Episode | null>
Inherited from
listRecent()?
optional listRecent(
scope,
limit,
options?): Promise<readonly Episode[]>;Defined in: packages/memory/src/internal/storage-adapter.ts:79
Most-recent episodes by end time (newest first), with no FTS / vector query - recency, not relevance (MCON-1). Powers EpisodicMemory.recent() and the deep-phase reflection gate. The default @graphorin/store-sqlite adapter implements it.
Parameters
| Parameter | Type |
|---|---|
scope | SessionScope |
limit | number |
options? | { includeQuarantined?: boolean; } |
options.includeQuarantined? | boolean |
Returns
Promise<readonly Episode[]>
put()
put(episode): Promise<void>;Defined in: packages/core/dist/contracts/memory-store.d.ts
Parameters
| Parameter | Type |
|---|---|
episode | Episode |
Returns
Promise<void>
Inherited from
putWithEmbedding()?
optional putWithEmbedding(episode, options): Promise<void>;Defined in: packages/memory/src/internal/storage-adapter.ts:57
Parameters
| Parameter | Type |
|---|---|
episode | Episode |
options | EmbeddedWriteOptions |
Returns
Promise<void>
search()
search(scope, opts): Promise<readonly MemoryHit<Episode>[]>;Defined in: packages/core/dist/contracts/memory-store.d.ts
Parameters
| Parameter | Type |
|---|---|
scope | SessionScope |
opts | MemorySearchOptions |
Returns
Promise<readonly MemoryHit<Episode>[]>
Inherited from
searchVector()?
optional searchVector(
scope,
embedding,
embedderId,
topK,
asOf?,
includeQuarantined?): Promise<readonly MemoryHit<Episode>[]>;Defined in: packages/memory/src/internal/storage-adapter.ts:58
Parameters
| Parameter | Type | Description |
|---|---|---|
scope | SessionScope | - |
embedding | Float32Array | - |
embedderId | string | - |
topK | number | - |
asOf? | string | Point-in-time filter (started_at <= asOf, ISO-8601). P0-2. |
includeQuarantined? | boolean | Include quarantined episodes (validation/inspector path). P1-4. |
Returns
Promise<readonly MemoryHit<Episode>[]>
setStatus()?
optional setStatus(
id,
status,
reason?,
scope?): Promise<void>;Defined in: packages/memory/src/internal/storage-adapter.ts:89
Set an episode's retrieval-trust status (MCON-2) - promote a quarantined (auto-formed) episode into default recall or re-quarantine an active one, with a memory_history audit row. Powers EpisodicMemory.validate.
Parameters
| Parameter | Type |
|---|---|
id | string |
status | MemoryStatus |
reason? | string |
scope? | SessionScope |
Returns
Promise<void>