feat(runtime): add leanvec ood (#264)

Add LeanVec OOD API to runtime.

Supersedes #262 as it achieves the same thing with only a minor version
bump.

Author: ahuber21

bindings/cpp/CMakeLists.txt

@@ -98,14 +98,14 @@ if (SVS_RUNTIME_ENABLE_LVQ_LEANVEC)
     else()
         # Links to LTO-enabled static library, requires GCC/G++ 11.2
         if(CMAKE_CXX_COMPILER_ID STREQUAL "GNU" AND CMAKE_CXX_COMPILER_VERSION VERSION_GREATER_EQUAL "11.2" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS "11.3")
-            set(SVS_URL "https://github.com/intel/ScalableVectorSearch/releases/download/v1.0.0-dev/svs-shared-library-1.0.0-NIGHTLY-20251119-807-lto.tar.gz"
+            set(SVS_URL "https://github.com/intel/ScalableVectorSearch/releases/download/nightly/svs-shared-library-lto-nightly-2026-02-05-1017.tar.gz"
                 CACHE STRING "URL to download SVS shared library")
         else()
             message(WARNING
                 "Pre-built LVQ/LeanVec SVS library requires GCC/G++ v.11.2 to apply LTO optimizations."
                 "Current compiler: ${CMAKE_CXX_COMPILER_ID} ${CMAKE_CXX_COMPILER_VERSION}"
             )
-            set(SVS_URL "https://github.com/intel/ScalableVectorSearch/releases/download/v0.0.11/svs-shared-library-0.0.11.tar.gz"
+            set(SVS_URL "https://github.com/intel/ScalableVectorSearch/releases/download/nightly/svs-shared-library-nightly-2026-02-05-1017.tar.gz"
                 CACHE STRING "URL to download SVS shared library")
         endif()
         include(FetchContent)

bindings/cpp/include/svs/runtime/training.h

@@ -27,11 +27,41 @@ namespace v0 {
 
 struct SVS_RUNTIME_API LeanVecTrainingData {
     virtual ~LeanVecTrainingData();
+
+    /* Build LeanVec training data (compression matrices) from the provided
+     * data.
+     * @param training_data Output parameter to the created training data object
+     * @param dim Dimensionality of the input data and queries
+     * @param n Number of data points and queries
+     * @param x Pointer to the input data
+     * @param leanvec_dims Number of dimensions in the resulting LeanVec data
+     */
+    static Status build(
+        LeanVecTrainingData** training_data,
+        size_t dim,
+        size_t n,
+        const float* x,
+        size_t leanvec_dims
+    ) noexcept;
+
+    /* Build LeanVec training data (compression matrices) from the provided
+     * data.
+     * Accepts optional training queries for out-of-distribution training.
+     * @param training_data Output parameter to the created training data object
+     * @param dim Dimensionality of the input data and queries
+     * @param n Number of data points and queries
+     * @param x Pointer to the input data
+     * @param n_q Number of training queries (can be 0)
+     * @param x_q Pointer to the training queries (can be nullptr)
+     * @param leanvec_dims Number of dimensions in the resulting LeanVec data
+     */
     static Status build(
         LeanVecTrainingData** training_data,
         size_t dim,
         size_t n,
         const float* x,
+        size_t n_q,
+        const float* x_q,
         size_t leanvec_dims
     ) noexcept;
 

bindings/cpp/include/svs/runtime/version.h

@@ -41,7 +41,7 @@
 
 #ifndef SVS_RUNTIME_VERSION_MINOR
 /// Minor version number - incremented for backward-compatible feature additions
-#define SVS_RUNTIME_VERSION_MINOR 1
+#define SVS_RUNTIME_VERSION_MINOR 2
 #endif
 
 #ifndef SVS_RUNTIME_VERSION_PATCH
@@ -51,7 +51,7 @@
 
 #ifndef SVS_RUNTIME_VERSION_STRING
 /// Complete version string
-#define SVS_RUNTIME_VERSION_STRING "0.1.0"
+#define SVS_RUNTIME_VERSION_STRING "0.2.0"
 #endif
 
 #ifndef SVS_RUNTIME_API_VERSION

bindings/cpp/src/training.cpp

@@ -40,6 +40,27 @@ Status LeanVecTrainingData::build(
     });
 }
 
+Status LeanVecTrainingData::build(
+    LeanVecTrainingData** training_data,
+    size_t dim,
+    size_t n,
+    const float* x,
+    size_t n_q,
+    const float* x_q,
+    size_t leanvec_dims
+) noexcept {
+    if (n_q == 0 || !x_q) {
+        return build(training_data, dim, n, x, leanvec_dims);
+    }
+
+    return runtime_error_wrapper([&] {
+        const auto data = svs::data::ConstSimpleDataView<float>(x, n, dim);
+        const auto queries = svs::data::ConstSimpleDataView<float>(x_q, n_q, dim);
+        *training_data = new LeanVecTrainingDataManager{
+            LeanVecTrainingDataImpl{data, queries, leanvec_dims}};
+    });
+}
+
 Status LeanVecTrainingData::destroy(LeanVecTrainingData* training_data) noexcept {
     return runtime_error_wrapper([&] { delete training_data; });
 }

bindings/cpp/src/training_impl.h

@@ -45,6 +45,14 @@ struct LeanVecTrainingDataImpl {
         : leanvec_dims_{leanvec_dims}
         , leanvec_matrices_{compute_leanvec_matrices(data, leanvec_dims)} {}
 
+    LeanVecTrainingDataImpl(
+        const svs::data::ConstSimpleDataView<float>& data,
+        const svs::data::ConstSimpleDataView<float>& queries,
+        size_t leanvec_dims
+    )
+        : leanvec_dims_{leanvec_dims}
+        , leanvec_matrices_{compute_leanvec_matrices_ood(data, queries, leanvec_dims)} {}
+
     size_t get_leanvec_dims() const { return leanvec_dims_; }
     const LeanVecMatricesType& get_leanvec_matrices() const { return leanvec_matrices_; }
 
@@ -83,6 +91,18 @@ struct LeanVecTrainingDataImpl {
         // leading explicit creation of a copy of the matrix "to avoid double free".
         return LeanVecMatricesType{std::move(matrix), std::move(query_matrix)};
     }
+
+    static LeanVecMatricesType compute_leanvec_matrices_ood(
+        const svs::data::ConstSimpleDataView<float>& data,
+        const svs::data::ConstSimpleDataView<float>& queries,
+        size_t leanvec_dims
+    ) {
+        auto threadpool = default_threadpool();
+
+        return svs::leanvec::compute_leanvec_matrices_ood<svs::Dynamic>(
+            data, queries, threadpool, svs::lib::MaybeStatic{leanvec_dims}
+        );
+    }
 };
 
 struct LeanVecTrainingDataManager : public svs::runtime::LeanVecTrainingData {