Skip to content

v0.2.0

Choose a tag to compare

View all tags
@tonytonycoder11 tonytonycoder11 released this 20 Jul 11:56
v0.2.0
33fe273
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

0.2.0 covers Tier 1 "robustness, DX and reach" through Tier 3 "data and collections": the
modern /points/query search engine, payload and vector management, and the correctness work that
had to come first. It opens with a data-loss fix, which is why that section is first.

Fixed

  • delete-by-filter data loss: a delete whose filter clauses were all empty (e.g.
    delete(c) { must { } }, or must { if (cond) … } where cond is false at runtime) is no longer
    sent as a match-all filter that would delete every point in the collection. Empty clause blocks now
    normalize away, and delete-by-filter rejects an all-empty filter before issuing any request.
  • collectionExists now returns false on a 404 instead of throwing, matching its documented contract.
  • KdrantException.CollectionNotFound now carries the server's error message when the server provides one.

Security

  • The client rejects a configuration that sets an apiKey without useTls, so an API key is never
    sent over plaintext HTTP.

Added

  • Collection config tuning: updateCollection { optimizers = …; hnsw = …; quantization = … } (PATCH),
    and optimizers / quantization (QuantizationConfig.Scalar / .Binary) on createCollection.
  • Payload field indexes (createPayloadIndex(field, PayloadSchemaType.KEYWORD) / deletePayloadIndex), so
    filtering on a field scales instead of doing a full scan; and payload mutations setPayload /
    overwritePayload / deletePayload / clearPayload over a points-or-filter selector.
  • Vector mutations: updateVectors (write new vectors to existing points, keeping payload) and
    deleteVectors (remove named vectors from the selected points).
  • Advanced retrieval queries on search: recommend { positive(...); negative(...); strategy = ... },
    discover { target(...); context(...) }, and context { pair(...) }. Examples (VectorInput) accept a
    dense/sparse vector or a point id.
  • Batch and grouped search: searchBatch { search { } … } (several searches in one round-trip, hits per
    search) and searchGroups(groupBy = …) { } returning List<PointGroup>.
  • Sparse & multi-vectors: VectorData.Sparse / MultiDense, sparseVector(name) { modifier = Modifier.IDF }
    and per-vector multivector in createCollection, and querySparse(...) / queryMulti(...) — enabling
    true dense+sparse hybrid search combined with M14 fusion. Response decoding now degrades an unknown vector
    shape to VectorData.Raw instead of failing the whole response.
  • Modern /points/query search: a polymorphic query (nearest by vector or by point id, orderBy,
    sample), nestable prefetch { } sub-requests, and hybrid-search fusion (rrf(k, weights) / dbsf()),
    plus lookupFrom for cross-collection id lookups. The previous query(vector) call is unchanged.
  • Typed payload access: kdrantJson (public default Json), ScoredPoint.payloadAs<T>() /
    Record.payloadAs<T>(), and QdrantClient.searchAs<T>(): List<Hit<T>> to decode hit payloads
    straight into your own types.
  • Collection conveniences: getCollectionOrNull, race-tolerant createCollectionIfNotExists(...): Boolean,
    and a createCollection(name, size, distance = COSINE) shorthand.
  • PayloadBuilder index-assignment sugar: payload["key"] = value (operator set, accepts null).
  • Automatic retries with exponential backoff + jitter for transient failures (HTTP 429/502/503/504 and
    transient I/O errors), honoring the server's Retry-After header. Tunable via maxRetries,
    retryBaseDelay, and retryMaxDelay on the client config (maxRetries = 0 disables retries).
  • Finer error taxonomy: KdrantException.RateLimited (429, carrying Retry-After), ServiceUnavailable
    (503), ServerError (other 5xx), and AlreadyExists (409).
  • Client-side validation of collection parameters: vector size, shardNumber, and replicationFactor
    must be positive, with error messages that echo the received value.
  • kdrant-bom — a Bill of Materials module to keep kdrant-core and kdrant-transport-rest on one
    aligned version.

Changed

  • Server errors (HTTP 5xx other than 503) now surface as KdrantException.ServerError instead of
    Transport, which is now reserved for connection-level I/O failures. HTTP 408 maps to Timeout
    and 409 to AlreadyExists.
  • local.properties is no longer tracked in version control.

Install

dependencies {
    implementation("io.github.nacode-studios:kdrant-transport-rest:0.2.0")
}

Full changelog: https://github.com/NaCode-Studios/Kdrant/blob/v0.2.0/CHANGELOG.md

Assets 2
Loading