Skip to content

Changelog

All notable changes to langchain-cockroachdb will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

[0.3.0] - 2026-07-15

Fixed

  • Hybrid search now actually executes. Setting hybrid_search_config previously had no effect: only vector similarity ran and the FTS half never fired (#7). The regular search methods now run both searches in parallel and fuse the results.

Added

  • fts_language parameter on ainit_vectorstore_table for non-English tsvector columns
  • fetch_k keyword argument to control the hybrid candidate pool size
  • fts_rank_normalization option exposing the ts_rank bitmask
  • Score normalization for weighted sum fusion

Changed

  • Default fusion method is now reciprocal rank fusion. Pass fusion_type="weighted_sum" for the previous default.
  • HybridSearchConfig validates fts_query_language

0.2.1 - 2026-03-24

Changed

  • Checkpointer query performance optimization: replaced correlated subqueries with separate lightweight queries and raw BYTEA deserialization.
  • Batch fetching in list(): 3 total queries instead of 2N+1.
  • Prepared statement caching (prepare_threshold=5) for query plan reuse.

Added

  • CockroachDB row-level TTL: enable_ttl() / disable_ttl() (sync and async)
  • Checkpointer performance benchmark script

0.2.0 - 2026-02-19

Added

  • LangGraph checkpointer: CockroachDBSaver and AsyncCockroachDBSaver for persisting LangGraph workflow state (short-term memory, human-in-the-loop, fault tolerance)
  • Multi-tenancy: opt-in namespace column on vectorstore for tenant isolation
  • Vectorstore standard tests compliance (25/25 LangChain standard tests passing)
  • Checkpointer guide, multi-tenancy guide, API reference, runnable examples

Changed

  • Clarified isolation level support: works with both SERIALIZABLE (default, recommended) and READ COMMITTED
  • Test suite expanded from 92 to 177 tests

0.1.0 - 2024-01-31

Added

  • Initial release of langchain-cockroachdb
  • CockroachDBEngine for connection management
  • AsyncCockroachDBVectorStore for async vector operations
  • CockroachDBVectorStore sync wrapper
  • CSPANNIndex for C-SPANN vector indexes
  • HybridSearchConfig for FTS + vector search
  • CockroachDBChatMessageHistory for chat persistence
  • Automatic retry logic with exponential backoff
  • Comprehensive test suite (92 tests)
  • Full documentation with mkdocs
  • 7 working examples
  • Support for Python 3.10-3.12

Features

  • Native CockroachDB VECTOR type support
  • C-SPANN distributed vector indexes
  • Advanced metadata filtering
  • Connection pooling with health checks
  • Configurable retry parameters
  • Both async and sync APIs
  • Multi-tenant index support