FilePersistentMemoryStore
Storage adapter for persistent memory blocks. Implementations:
FilePersistentMemoryStore(built-in default, file-system backed)- postgres / redis / vector — pluggable via this interface
The store is responsible for atomic durability and per-user/per-agent scoping; the runtime layer handles when to load + when to inject.
Implements
Section titled “Implements”Constructors
Section titled “Constructors”Constructor
Section titled “Constructor”new FilePersistentMemoryStore(opts?): FilePersistentMemoryStore;Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
|
|
|
Returns
Section titled “Returns”FilePersistentMemoryStore
Properties
Section titled “Properties”rootDir
Section titled “rootDir”readonly rootDir: string;Methods
Section titled “Methods”deleteBlock()
Section titled “deleteBlock()”deleteBlock( scope, owner,key): Promise<void>;Delete a block. No-op when missing.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
|
|
|
|
|
|
|
|
|
Returns
Section titled “Returns”Promise<void>
Implementation of
Section titled “Implementation of”PersistentMemoryStore.deleteBlock
listBlocks()
Section titled “listBlocks()”listBlocks(scope, owner): Promise<string[]>;List block keys for an owner within a scope.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
|
|
|
|
|
|
Returns
Section titled “Returns”Promise<string[]>
Implementation of
Section titled “Implementation of”PersistentMemoryStore.listBlocks
loadBlock()
Section titled “loadBlock()”loadBlock( scope, owner, key): Promise< | PersistentMemoryBlock| null>;Load a single block by (scope, owner, key). Returns null when the block does not exist yet (first time the agent ever ran for this owner). Implementations MUST NOT throw on missing — return null.
owner is typically the userId for scope=‘user’ / scope=‘shared’,
and the agentId for scope=‘agent’. Implementations should accept any
string and treat it as opaque.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
|
|
|
|
|
|
|
|
|
Returns
Section titled “Returns”Promise<
| PersistentMemoryBlock
| null>
Implementation of
Section titled “Implementation of”PersistentMemoryStore.loadBlock
saveBlock()
Section titled “saveBlock()”saveBlock(block, owner): Promise<void>;Persist a block atomically. Replaces the entire content.
Parameters
Section titled “Parameters”| Parameter | Type |
|---|---|
|
|
|
|
|
|
Returns
Section titled “Returns”Promise<void>