Sylin.Koan.Data.Vector.Abstractions
0.21.0
dotnet add package Sylin.Koan.Data.Vector.Abstractions --version 0.21.0
NuGet\Install-Package Sylin.Koan.Data.Vector.Abstractions -Version 0.21.0
<PackageReference Include="Sylin.Koan.Data.Vector.Abstractions" Version="0.21.0" />
<PackageVersion Include="Sylin.Koan.Data.Vector.Abstractions" Version="0.21.0" />
<PackageReference Include="Sylin.Koan.Data.Vector.Abstractions" />
paket add Sylin.Koan.Data.Vector.Abstractions --version 0.21.0
#r "nuget: Sylin.Koan.Data.Vector.Abstractions, 0.21.0"
#:package Sylin.Koan.Data.Vector.Abstractions@0.21.0
#addin nuget:?package=Sylin.Koan.Data.Vector.Abstractions&version=0.21.0
#tool nuget:?package=Sylin.Koan.Data.Vector.Abstractions&version=0.21.0
Sylin.Koan.Data.Vector.Abstractions
Supported provider-neutral contracts behind Koan's Entity Vector runtime and provider packages.
Provider-neutral contracts for Koan vector search: adapter factories, repositories, capabilities, query and match shapes, export batches, schema descriptions, and provider-selection annotations. Referencing this package alone does not register a vector runtime or select a backend.
Install
dotnet add package Sylin.Koan.Data.Vector.Abstractions
Application developers normally reference Sylin.Koan.Data.Vector and a provider. Reference Abstractions directly
when authoring a vector provider, shared query library, or projection that must not activate the runtime.
Smallest meaningful use
A provider-neutral library can construct the exact query handed to every vector repository:
using Koan.Data.Vector.Abstractions;
var query = new VectorQueryOptions(
Query: embedding,
TopK: 10,
SearchText: "annual revenue",
Alpha: 0.65);
Provider authors implement IVectorAdapterFactory and return IVectorSearchRepository<TEntity,TKey> instances.
VectorAdapterAttribute is the explicit entity-level provider request; VectorCaps describes optional repository
behavior without pretending every backend has the same guarantees.
Guarantees and boundaries
- This package depends on entity/filter/naming vocabulary from
Sylin.Koan.Data.Abstractions; it does not depend on Data.Core, dependency injection, the vector runtime, or any provider client. - Query options express intent. Hybrid text, filtering, continuation, export, flush, and embedding retrieval remain provider capabilities and may be unsupported.
- Repository default methods fail with
NotSupportedExceptionfor optional operations rather than simulating them. - Provider election, memoization, physical collection naming, active-participation health, and entity facades belong
to
Sylin.Koan.Data.Vector. - Score scale, consistency, indexing latency, dimensionality, and distance behavior are backend guarantees; this package does not normalize them into false equivalence.
See TECHNICAL.md for the complete SPI and schema boundary.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Sylin.Koan.Data.Abstractions (>= 0.21.0 && < 0.22.0)
NuGet packages (9)
Showing the top 5 NuGet packages that depend on Sylin.Koan.Data.Vector.Abstractions:
| Package | Downloads |
|---|---|
|
Sylin.Koan.Data.Vector
Entity-first Koan vector runtime: provider election, memoized repository resolution, isolation-aware naming, querying, health participation, and facades. |
|
|
Sylin.Koan.Data.Vector.Connector.Milvus
Milvus vector adapter for Koan: plan-owned spaces, complete points, native filters, and truthful similarity over REST v2. |
|
|
Sylin.Koan.Data.Vector.Connector.Weaviate
Weaviate vector provider for Koan: plan-bound entity vectors, native filtering, complete points, and awaited Session visibility. |
|
|
Sylin.Koan.Data.Connector.ElasticSearch
Elasticsearch vector provider for Koan: plan-bound complete points, native filtered kNN search, normalized similarity, and session-visible mutations. |
|
|
Sylin.Koan.Data.Connector.OpenSearch
OpenSearch vector provider for Koan: plan-bound complete points, native filtered k-NN search, normalized similarity, and session-visible mutations. |
GitHub repositories
This package is not used by any popular GitHub repositories.