agentic_vector 0.1.1
agentic_vector: ^0.1.1 copied to clipboard
A vector store port with metadata filtering, exact in-process search with snapshots, and a Qdrant adapter. Typed Float64List arithmetic throughout.
Changelog #
0.1.1 #
- Shortened the package description to the 60-180 character window pana scores against. Search engines truncate anything longer, so the ten points it withheld were pointing at a real defect: the useful half of the sentence was never being shown.
0.1.0 #
Initial release of the vector layer.
Added #
- Values —
VectorRecord,VectorQueryandVectorMatch. Identifiers are caller-supplied, which is what makes re-indexing a changed document replace its chunks instead of duplicating them. Search results omit vectors unless asked for;VectorRecord.hasVectorsays which you have. - Filtering — a sealed
MetadataFilterhierarchy (equals,notEquals,inValues,greaterThan,lessThan,exists,and,or,not) that every adapter must translate in full, so a new filter kind is a compile error rather than a silently ignored predicate. - Similarity —
SimilarityMetriccovering cosine, dot product and Euclidean, all scored higher-is-better so thattopKordering andminScorenever invert when the metric changes; pluscosineSimilarity,dotProduct,euclideanDistanceandnormaliseover raw lists. - Port —
VectorStorewithupsert,search,get,delete,deleteWhere,countandclear, andVectorStoreOperationssupplyingupsertAll(batched and cancellable),searchVector,exists,deleteOneand thecheckDimensions/checkNamespaceguards adapters call. - In-process store —
InMemoryVectorStore, exact by construction, with namespaces, oldest-first eviction undermaxRecords, andsnapshot/fromJsonso an offline-first app embeds once and restores thereafter. - Qdrant adapter —
QdrantVectorStore, including deterministic UUID derivation for identifiers Qdrant will not accept, score-direction conversion for Euclidean collections in both directions, full filter translation, andensureCollection/dropCollection. - Composition —
EmbeddingIndexbinds an embedding model to a store, batching to each side's limit, using the document and query encoders correctly, and refusing a width mismatch at construction rather than after ingestion. - Decorators —
DelegatingVectorStore,ObservableVectorStore(traces, logs and events) andNamespacedVectorStore(a handle that cannot reach another tenant's partition). - Events —
VectorUpsertCompleted,VectorSearchCompleted(carrying requested against returned, the number worth alerting on),VectorDeleteCompletedandVectorOperationFailed.