@vibe-agent-toolkit/rag-lancedb

Implements persistent vector database storage using LanceDB as the underlying engine, enabling efficient similarity search over embedded documents. The capability abstracts LanceDB's columnar storage format and vector indexing (IVF-PQ by default) behind a standardized RAG interface, allowing agents to store and retrieve semantically similar content without managing database infrastructure directly. Supports batch ingestion of embeddings and configurable distance metrics for similarity computation.

Accepts raw documents (text, markdown, code) and orchestrates the embedding generation and storage workflow through a pluggable embedding provider interface. The pipeline abstracts the choice of embedding model (OpenAI, Hugging Face, local models) and handles chunking, metadata extraction, and batch ingestion into LanceDB without coupling agents to a specific embedding service. Supports configurable chunk sizes and overlap for context preservation.

Executes vector similarity queries against the LanceDB index using configurable distance metrics (cosine, L2, dot product) and returns ranked results with relevance scores. The search capability supports filtering by metadata fields and limiting result sets, enabling agents to retrieve the most contextually relevant documents for a given query embedding. Internally leverages LanceDB's optimized vector search algorithms (IVF-PQ indexing) for sub-linear query latency.

Provides a standardized interface for RAG operations (store, retrieve, delete) that integrates seamlessly with the vibe-agent-toolkit's agent execution model. The abstraction allows agents to invoke RAG operations as tool calls within their reasoning loops, treating knowledge retrieval as a first-class agent capability alongside LLM calls and external tool invocations. Implements the toolkit's pluggable interface pattern, enabling agents to swap LanceDB for alternative vector backends without code changes.

Supports removal of documents from the vector index by document ID or metadata criteria, with automatic index cleanup and optimization. The capability enables agents to manage knowledge base lifecycle (adding, updating, removing documents) without manual index reconstruction. Implements efficient deletion strategies that avoid full re-indexing when possible, though some operations may require index rebuilding depending on the underlying LanceDB version.

Stores and retrieves arbitrary metadata alongside document embeddings (e.g., source URL, timestamp, document type, author), enabling agents to filter and contextualize retrieval results. Metadata is stored in LanceDB's columnar format alongside vectors, allowing efficient filtering and ranking based on document attributes. Supports metadata extraction from document headers or custom metadata injection during ingestion.