VectorStore
Defined in: vector-store.interface.ts:85
Backend-agnostic vector storage contract.
Implementations wrap a concrete engine (pgvector) so the memory layer can perform the vector lifecycle (upsert / delete / search) without depending on a specific database.
Properties
Section titled “Properties”backend
Section titled “backend”
readonlybackend:"pgvector"
Defined in: vector-store.interface.ts:87
Human-readable backend name, used for logging and diagnostics.
Methods
Section titled “Methods”delete()
Section titled “delete()”delete(
ids):Promise<void>
Defined in: vector-store.interface.ts:103
Remove vectors by id. Missing ids are ignored.
Parameters
Section titled “Parameters”string[]
Returns
Section titled “Returns”Promise<void>
ensureReady()
Section titled “ensureReady()”ensureReady(
dimensions):Promise<void>
Defined in: vector-store.interface.ts:93
Ensure the backing collection/table exists with the given dimensionality. Implementations must be idempotent.
Parameters
Section titled “Parameters”dimensions
Section titled “dimensions”number
Returns
Section titled “Returns”Promise<void>
reset()
Section titled “reset()”reset():
Promise<void>
Defined in: vector-store.interface.ts:109
Remove all stored vectors so a subsequent upsert rebuilds the index from scratch. Used by a full reindex for a clean backfill. Idempotent.
Returns
Section titled “Returns”Promise<void>
search()
Section titled “search()”search(
vector,filter,limit?):Promise<VectorSearchResult[]>
Defined in: vector-store.interface.ts:114
Run a k-nearest-neighbour search filtered by VectorSearchFilter.
Parameters
Section titled “Parameters”vector
Section titled “vector”number[]
filter
Section titled “filter”limit?
Section titled “limit?”number
Returns
Section titled “Returns”Promise<VectorSearchResult[]>
upsert()
Section titled “upsert()”upsert(
records):Promise<void>
Defined in: vector-store.interface.ts:98
Insert or replace one or more vectors.
Parameters
Section titled “Parameters”records
Section titled “records”Returns
Section titled “Returns”Promise<void>