Class: InMemoryVectorStore
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:67
Implements the IVectorStore interface using in-memory data structures.
Provides a simple, fast vector store primarily for development and testing.
Implements
Implements
Constructors
Constructor
new InMemoryVectorStore():
InMemoryVectorStore
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:77
Constructs an InMemoryVectorStore instance.
Note: The store is not ready for use until initialize is called.
Returns
InMemoryVectorStore
Methods
checkHealth()
checkHealth():
Promise<{details?:any;isHealthy:boolean; }>
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:423
Async
Checks the operational health of the vector store provider. This might involve pinging the service, checking connection status, or verifying authentication.
Returns
Promise<{ details?: any; isHealthy: boolean; }>
A promise that resolves with the health status.
details can include specific error messages or status information.
Implementation of
collectionExists()
collectionExists(
collectionName):Promise<boolean>
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:206
Async
Checks if a collection with the given name exists in the vector store.
Parameters
collectionName
string
The name of the collection to check.
Returns
Promise<boolean>
A promise that resolves with true if the collection exists, false otherwise.
Throws
If the check fails for reasons other than existence (e.g., connection issue).
Implementation of
createCollection()
createCollection(
collectionName,dimension,options?):Promise<void>
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:164
Creates or replaces an in-memory collection.
Parameters
collectionName
string
dimension
number
options?
Returns
Promise<void>
Implementation of
delete()
delete(
collectionName,ids?,options?):Promise<DeleteResult>
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:370
Async
Deletes documents from a specified collection by their IDs or by a metadata filter.
Parameters
collectionName
string
The name of the collection to delete documents from.
ids?
string[]
An array of document IDs to delete.
options?
Optional parameters, including metadata filters or a deleteAll flag.
If ids are provided, options.filter might be ignored or combined,
depending on store behavior. Use with caution.
Returns
Promise<DeleteResult>
A promise that resolves with the result of the delete operation.
Throws
If the delete operation fails.
Implementation of
deleteCollection()
deleteCollection(
collectionName):Promise<void>
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:214
Async
Deletes an entire collection from the vector store. This is a destructive operation.
Parameters
collectionName
string
The name of the collection to delete.
Returns
Promise<void>
A promise that resolves when the collection is successfully deleted.
Throws
If collection deletion fails.
Implementation of
getStats()
getStats(
collectionName?):Promise<Record<string,any>>
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:466
Async
Optional: Retrieves statistics about a specific collection or the store itself. The structure of the returned statistics is provider-dependent.
Parameters
collectionName?
string
Optional: The name of the collection to get stats for. If omitted, may return store-wide stats if supported.
Returns
Promise<Record<string, any>>
A promise that resolves with a statistics object.
Throws
If fetching statistics fails.
Implementation of
initialize()
initialize(
config):Promise<void>
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:85
Async
Initializes the vector store provider with its specific configuration. This method must be called before any other operations can be performed. It sets up connections, authenticates, and prepares the store for use.
Parameters
config
The configuration object specific to this vector store provider.
This is typically a more specific type that extends VectorStoreProviderConfig.
Returns
Promise<void>
A promise that resolves when initialization is complete.
Throws
If initialization fails (e.g., invalid configuration, connection error, authentication failure).
Implementation of
query()
query(
collectionName,queryEmbedding,options?):Promise<QueryResult>
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:274
Async
Queries a specified collection for documents similar to the provided query embedding.
Parameters
collectionName
string
The name of the collection to query.
queryEmbedding
number[]
The query vector embedding.
options?
Optional parameters for the query operation, including filters and topK.
Returns
Promise<QueryResult>
A promise that resolves with the query results.
Throws
If the query operation fails.
Implementation of
scanByMetadata()
scanByMetadata(
collectionName,options?):Promise<MetadataScanResult>
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:331
Optional: Enumerates documents using metadata-only filtering without requiring a query embedding.
Parameters
collectionName
string
options?
MetadataScanOptions
Returns
Promise<MetadataScanResult>
Implementation of
shutdown()
shutdown():
Promise<void>
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:444
Async
Gracefully shuts down the vector store provider, releasing any resources such as database connections or client instances.
Returns
Promise<void>
A promise that resolves when shutdown is complete.
Implementation of
upsert()
upsert(
collectionName,documents,options?):Promise<UpsertResult>
Defined in: packages/agentos/src/cognition/rag/vector_stores/InMemoryVectorStore.ts:231
Async
Upserts (inserts or updates) a batch of documents into a specified collection. If a document with the same ID already exists, it is typically updated; otherwise, it's inserted.
Parameters
collectionName
string
The name of the collection (or index, class, etc.) to upsert documents into.
documents
An array of documents to upsert.
options?
Optional parameters for the upsert operation.
Returns
Promise<UpsertResult>
A promise that resolves with the result of the upsert operation.
Throws
If the upsert operation fails critically.