mcp-code-indexer 4.1.0__tar.gz → 4.2.1__tar.gz

{mcp_code_indexer-4.1.0 → mcp_code_indexer-4.2.1}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.3
 Name: mcp-code-indexer
-Version: 4.1.0
+Version: 4.2.1
 Summary: MCP server that tracks file descriptions across codebases, enabling AI agents to efficiently navigate and understand code through searchable summaries and token-aware overviews.
 License: MIT
 Keywords: mcp,model-context-protocol,code-indexer,ai-tools,codebase-navigation,file-descriptions,llm-tools
 Author: MCP Code Indexer Contributors
 Maintainer: MCP Code Indexer Contributors
-Requires-Python: >=3.9,<4.0
+Requires-Python: >=3.10,<3.13
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Framework :: AsyncIO
@@ -14,16 +14,15 @@ Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.9
 Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
-Provides-Extra: vector
 Requires-Dist: aiofiles (==23.2.0)
 Requires-Dist: aiohttp (>=3.8.0)
 Requires-Dist: aiosqlite (==0.19.0)
@@ -33,10 +32,15 @@ Requires-Dist: importlib-metadata (>=1.0.0) ; python_version < "3.8"
 Requires-Dist: mcp (>=1.9.0)
 Requires-Dist: pydantic (>=2.8.0)
 Requires-Dist: python-multipart (>=0.0.6)
+Requires-Dist: pyyaml (>=6.0)
 Requires-Dist: tenacity (>=8.0.0)
 Requires-Dist: tiktoken (>=0.9.0)
 Requires-Dist: tomli (>=1.2.0) ; python_version < "3.11"
+Requires-Dist: tree-sitter (>=0.25.0)
+Requires-Dist: turbopuffer (>=0.6.0)
 Requires-Dist: uvicorn (>=0.24.0)
+Requires-Dist: voyageai (>=0.3.0)
+Requires-Dist: watchdog (>=6.0.0)
 Project-URL: Documentation, https://github.com/fluffypony/mcp-code-indexer/blob/main/README.md
 Project-URL: Homepage, https://github.com/fluffypony/mcp-code-indexer
 Project-URL: Repository, https://github.com/fluffypony/mcp-code-indexer
@@ -44,8 +48,8 @@ Description-Content-Type: text/markdown
 
 # MCP Code Indexer 🚀
 
-[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?46)](https://badge.fury.io/py/mcp-code-indexer)
-[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?46)](https://pypi.org/project/mcp-code-indexer/)
+[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?48)](https://badge.fury.io/py/mcp-code-indexer)
+[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?48)](https://pypi.org/project/mcp-code-indexer/)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
 A production-ready **Model Context Protocol (MCP) server** that revolutionizes how AI agents navigate and understand codebases. Built for high-concurrency environments with advanced database resilience, the server provides instant access to intelligent descriptions, semantic search, and context-aware recommendations while maintaining 800+ writes/sec throughput.
@@ -215,12 +219,15 @@ Vector Mode transforms how you search and understand codebases by using AI embed
 ### 🚀 Quick Start
 
 ```bash
-# Install vector mode dependencies
-pip install mcp-code-indexer[vector]
+# Install MCP Code Indexer (includes vector mode)
+pip install mcp-code-indexer
 
 # Set required API keys
 export VOYAGE_API_KEY="pa-your-voyage-api-key"
-export TURBOPUFFER_API_KEY="your-turbopuffer-api-key" 
+export TURBOPUFFER_API_KEY="your-turbopuffer-api-key"
+
+# Optional: Configure region (default: gcp-europe-west3)
+export TURBOPUFFER_REGION="gcp-europe-west3" 
 
 # Start with vector mode enabled
 mcp-code-indexer --vector

{mcp_code_indexer-4.1.0 → mcp_code_indexer-4.2.1}/README.md

@@ -1,7 +1,7 @@
 # MCP Code Indexer 🚀
 
-[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?46)](https://badge.fury.io/py/mcp-code-indexer)
-[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?46)](https://pypi.org/project/mcp-code-indexer/)
+[![PyPI version](https://badge.fury.io/py/mcp-code-indexer.svg?48)](https://badge.fury.io/py/mcp-code-indexer)
+[![Python](https://img.shields.io/pypi/pyversions/mcp-code-indexer.svg?48)](https://pypi.org/project/mcp-code-indexer/)
 [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
 A production-ready **Model Context Protocol (MCP) server** that revolutionizes how AI agents navigate and understand codebases. Built for high-concurrency environments with advanced database resilience, the server provides instant access to intelligent descriptions, semantic search, and context-aware recommendations while maintaining 800+ writes/sec throughput.
@@ -171,12 +171,15 @@ Vector Mode transforms how you search and understand codebases by using AI embed
 ### 🚀 Quick Start
 
 ```bash
-# Install vector mode dependencies
-pip install mcp-code-indexer[vector]
+# Install MCP Code Indexer (includes vector mode)
+pip install mcp-code-indexer
 
 # Set required API keys
 export VOYAGE_API_KEY="pa-your-voyage-api-key"
-export TURBOPUFFER_API_KEY="your-turbopuffer-api-key" 
+export TURBOPUFFER_API_KEY="your-turbopuffer-api-key"
+
+# Optional: Configure region (default: gcp-europe-west3)
+export TURBOPUFFER_REGION="gcp-europe-west3" 
 
 # Start with vector mode enabled
 mcp-code-indexer --vector

{mcp_code_indexer-4.1.0 → mcp_code_indexer-4.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "mcp-code-indexer"
-version = "4.1.0"
+version = "4.2.1"
 description = "MCP server that tracks file descriptions across codebases, enabling AI agents to efficiently navigate and understand code through searchable summaries and token-aware overviews."
 authors = ["MCP Code Indexer Contributors"]
 maintainers = ["MCP Code Indexer Contributors"]
@@ -43,7 +43,7 @@ classifiers = [
 packages = [{include = "mcp_code_indexer", from = "src"}]
 
 [tool.poetry.dependencies]
-python = "^3.9"
+python = ">=3.10,<3.13"
 tiktoken = ">=0.9.0"
 mcp = ">=1.9.0"
 gitignore-parser = "0.1.11"
@@ -58,15 +58,12 @@ importlib-metadata = {version = ">=1.0.0", markers = "python_version < '3.8'"}
 fastapi = ">=0.104.0"
 uvicorn = ">=0.24.0"
 python-multipart = ">=0.0.6"
-
-[tool.poetry.extras]
-vector = [
-    "voyageai",
-    "turbopuffer", 
-    "tree-sitter",
-    "watchdog",
-    "pyyaml"
-]
+# Vector mode dependencies (always included)
+voyageai = ">=0.3.0"
+turbopuffer = ">=0.6.0"
+tree-sitter = ">=0.25.0"
+watchdog = ">=6.0.0"
+pyyaml = ">=6.0"
 
 [tool.poetry.group.dev.dependencies]
 pytest = ">=8.0.0"

{mcp_code_indexer-4.1.0 → mcp_code_indexer-4.2.1}/src/mcp_code_indexer/main.py

@@ -1019,7 +1019,7 @@ async def main() -> None:
                 
                 # Check if vector mode is available
                 if not is_vector_mode_available():
-                    logger.error("Vector mode requires additional dependencies. Install with: pip install mcp-code-indexer[vector]")
+                    logger.error("Vector mode dependencies not found. Try reinstalling: pip install --upgrade mcp-code-indexer")
                     sys.exit(1)
                 
                 # Check API keys

{mcp_code_indexer-4.1.0 → mcp_code_indexer-4.2.1}/src/mcp_code_indexer/vector_mode/config.py

@@ -18,6 +18,7 @@ class VectorConfig:
     # API Configuration
     voyage_api_key: Optional[str] = None
     turbopuffer_api_key: Optional[str] = None
+    turbopuffer_region: str = "gcp-europe-west3"
     
     # Embedding Configuration  
     embedding_model: str = "voyage-code-2"
@@ -57,9 +58,10 @@ class VectorConfig:
         return cls(
             voyage_api_key=os.getenv("VOYAGE_API_KEY"),
             turbopuffer_api_key=os.getenv("TURBOPUFFER_API_KEY"),
-            embedding_model=os.getenv("VECTOR_EMBEDDING_MODEL", "voyage-code-2"),
+            turbopuffer_region=os.getenv("TURBOPUFFER_REGION", "gcp-europe-west3"),
+            embedding_model=os.getenv("VECTOR_EMBEDDING_MODEL", "voyage-code-3"),
             batch_size=int(os.getenv("VECTOR_BATCH_SIZE", "128")),
-            max_tokens_per_chunk=int(os.getenv("VECTOR_MAX_TOKENS", "1024")),
+            max_tokens_per_chunk=int(os.getenv("VECTOR_MAX_TOKENS", "2048")),
             similarity_threshold=float(os.getenv("VECTOR_SIMILARITY_THRESHOLD", "0.5")),
             max_search_results=int(os.getenv("VECTOR_MAX_RESULTS", "20")),
             enable_recency_boost=os.getenv("VECTOR_RECENCY_BOOST", "true").lower() == "true",
@@ -122,6 +124,16 @@ class VectorConfig:
             if not self.turbopuffer_api_key:
                 errors.append("TURBOPUFFER_API_KEY environment variable required for vector mode")
         
+        # Validate TurboPuffer region
+        supported_regions = [
+            'aws-ap-southeast-2', 'aws-eu-central-1', 'aws-us-east-1', 
+            'aws-us-east-2', 'aws-us-west-2', 'gcp-us-central1',
+            'gcp-us-west1', 'gcp-us-east4', 'gcp-europe-west3'
+        ]
+        if self.turbopuffer_region not in supported_regions:
+            errors.append(f"turbopuffer_region '{self.turbopuffer_region}' is not supported. " +
+                         f"Supported regions: {', '.join(supported_regions)}")
+        
         if self.batch_size <= 0:
             errors.append("batch_size must be positive")
         if self.max_tokens_per_chunk <= 0:

mcp_code_indexer-4.2.1/src/mcp_code_indexer/vector_mode/providers/__init__.py

@@ -0,0 +1,17 @@
+"""
+External service providers for vector mode.
+
+This package provides clean integrations with external services using official SDKs:
+- Voyage AI for embedding generation (voyageai SDK)
+- Turbopuffer for vector storage and search (turbopuffer SDK)
+"""
+
+from .voyage_client import VoyageClient, create_voyage_client
+from .turbopuffer_client import TurbopufferClient, create_turbopuffer_client
+
+__all__ = [
+    'VoyageClient',
+    'create_voyage_client', 
+    'TurbopufferClient',
+    'create_turbopuffer_client',
+]

mcp_code_indexer-4.2.1/src/mcp_code_indexer/vector_mode/providers/turbopuffer_client.py

@@ -0,0 +1,217 @@
+"""
+Turbopuffer client for vector storage and search using official SDK.
+
+Provides clean integration with Turbopuffer's vector database for storing
+embeddings and performing similarity searches. Supports configurable
+regions for optimal latency and data residency compliance.
+
+Default region: gcp-europe-west3 (Frankfurt)
+Configure via TURBOPUFFER_REGION environment variable.
+"""
+
+import logging
+import uuid
+from typing import List, Dict, Any, Optional
+import turbopuffer
+
+from ..config import VectorConfig
+
+logger = logging.getLogger(__name__)
+
+class TurbopufferClient:
+    """Clean Turbopuffer client using official SDK."""
+    
+    def __init__(self, api_key: str, region: str = "gcp-europe-west3"):
+        self.api_key = api_key
+        self.region = region
+        
+        # Initialize official TurboPuffer client
+        self.client = turbopuffer.Turbopuffer(
+            api_key=api_key,
+            region=region
+        )
+        logger.info(f"Initialized TurboPuffer client with region {region}")
+    
+    def health_check(self) -> bool:
+        """Check if Turbopuffer service is healthy."""
+        try:
+            namespaces = self.client.namespaces()
+            return True
+        except Exception as e:
+            logger.warning(f"Turbopuffer health check failed: {e}")
+            return False
+    
+    def generate_vector_id(self, project_id: str, chunk_id: int) -> str:
+        """Generate a unique vector ID."""
+        return f"{project_id}_{chunk_id}_{uuid.uuid4().hex[:8]}"
+    
+    def upsert_vectors(
+        self,
+        vectors: List[Dict[str, Any]],
+        namespace: str,
+        **kwargs
+    ) -> Dict[str, Any]:
+        """Store or update vectors in the database."""
+        if not vectors:
+            return {"upserted": 0}
+        
+        logger.info(f"Upserting {len(vectors)} vectors to namespace '{namespace}'")
+        
+        # Format vectors for Turbopuffer SDK
+        formatted_vectors = []
+        for vector in vectors:
+            if "id" not in vector or "values" not in vector:
+                raise ValueError("Each vector must have 'id' and 'values' fields")
+            
+            formatted_vector = {
+                "id": str(vector["id"]),
+                "vector": vector["values"],
+                "attributes": vector.get("metadata", {}),
+            }
+            formatted_vectors.append(formatted_vector)
+        
+        try:
+            ns = self.client.namespace(namespace)
+            ns.upsert(vectors=formatted_vectors)
+            
+            logger.info(f"Successfully upserted {len(vectors)} vectors")
+            return {"upserted": len(vectors)}
+            
+        except Exception as e:
+            logger.error(f"Failed to upsert vectors: {e}")
+            raise RuntimeError(f"Vector upsert failed: {e}")
+    
+    def search_vectors(
+        self,
+        query_vector: List[float],
+        top_k: int = 10,
+        namespace: str = "default",
+        filters: Optional[Dict[str, Any]] = None,
+        **kwargs
+    ) -> List[Dict[str, Any]]:
+        """Search for similar vectors."""
+        logger.debug(f"Searching {top_k} vectors in namespace '{namespace}'")
+        
+        try:
+            ns = self.client.namespace(namespace)
+            
+            results = ns.query(
+                rank_by=[("vector", "ANN", query_vector)],
+                top_k=top_k,
+                filters=filters,
+                include_attributes=True
+            )
+            
+            logger.debug(f"Found {len(results)} similar vectors")
+            return results
+            
+        except Exception as e:
+            logger.error(f"Vector search failed: {e}")
+            raise RuntimeError(f"Vector search failed: {e}")
+    
+    def delete_vectors(
+        self,
+        vector_ids: List[str],
+        namespace: str,
+        **kwargs
+    ) -> Dict[str, Any]:
+        """Delete vectors by ID."""
+        if not vector_ids:
+            return {"deleted": 0}
+        
+        logger.info(f"Deleting {len(vector_ids)} vectors from namespace '{namespace}'")
+        
+        try:
+            ns = self.client.namespace(namespace)
+            ns.delete(ids=vector_ids)
+            
+            logger.info(f"Successfully deleted vectors")
+            return {"deleted": len(vector_ids)}
+            
+        except Exception as e:
+            logger.error(f"Failed to delete vectors: {e}")
+            raise RuntimeError(f"Vector deletion failed: {e}")
+    
+    def list_namespaces(self) -> List[str]:
+        """List all available namespaces."""
+        try:
+            namespaces = self.client.namespaces()
+            return [ns.name for ns in namespaces]
+            
+        except Exception as e:
+            logger.error(f"Failed to list namespaces: {e}")
+            raise RuntimeError(f"Namespace listing failed: {e}")
+    
+    def create_namespace(self, namespace: str, dimension: int, **kwargs) -> Dict[str, Any]:
+        """Create a new namespace."""
+        logger.info(f"Creating namespace '{namespace}' with dimension {dimension}")
+        
+        try:
+            self.client.create_namespace(
+                name=namespace,
+                dimension=dimension
+            )
+            
+            logger.info(f"Successfully created namespace '{namespace}'")
+            return {"name": namespace, "dimension": dimension}
+            
+        except Exception as e:
+            logger.error(f"Failed to create namespace: {e}")
+            raise RuntimeError(f"Namespace creation failed: {e}")
+    
+    def delete_namespace(self, namespace: str) -> Dict[str, Any]:
+        """Delete a namespace and all its vectors."""
+        logger.warning(f"Deleting namespace '{namespace}' and all its vectors")
+        
+        try:
+            self.client.delete_namespace(namespace)
+            
+            logger.info(f"Successfully deleted namespace '{namespace}'")
+            return {"deleted": namespace}
+            
+        except Exception as e:
+            logger.error(f"Failed to delete namespace: {e}")
+            raise RuntimeError(f"Namespace deletion failed: {e}")
+    
+    def get_namespace_for_project(self, project_id: str) -> str:
+        """Get the namespace name for a project."""
+        # Use project ID as namespace, with prefix for safety
+        safe_project_id = "".join(c if c.isalnum() or c in "-_" else "_" for c in project_id)
+        return f"mcp_code_{safe_project_id}".lower()
+    
+    def search_with_metadata_filter(
+        self,
+        query_vector: List[float],
+        project_id: str,
+        chunk_type: Optional[str] = None,
+        file_path: Optional[str] = None,
+        top_k: int = 10,
+        **kwargs
+    ) -> List[Dict[str, Any]]:
+        """Search vectors with metadata filtering."""
+        namespace = self.get_namespace_for_project(project_id)
+        
+        # Build metadata filters
+        filters = {"project_id": project_id}
+        if chunk_type:
+            filters["chunk_type"] = chunk_type
+        if file_path:
+            filters["file_path"] = file_path
+        
+        return self.search_vectors(
+            query_vector=query_vector,
+            top_k=top_k,
+            namespace=namespace,
+            filters=filters,
+            **kwargs
+        )
+
+def create_turbopuffer_client(config: VectorConfig) -> TurbopufferClient:
+    """Create a Turbopuffer client from configuration."""
+    if not config.turbopuffer_api_key:
+        raise ValueError("TURBOPUFFER_API_KEY is required for vector storage")
+    
+    return TurbopufferClient(
+        api_key=config.turbopuffer_api_key,
+        region=config.turbopuffer_region,
+    )

mcp_code_indexer-4.2.1/src/mcp_code_indexer/vector_mode/providers/voyage_client.py

@@ -0,0 +1,119 @@
+"""
+Voyage AI client for embedding generation using official SDK.
+
+Provides clean integration with Voyage AI's embedding API for generating
+high-quality code embeddings using the voyage-code-2 model.
+"""
+
+import logging
+from typing import List, Dict, Any
+import voyageai
+
+from ..config import VectorConfig
+
+logger = logging.getLogger(__name__)
+
+class VoyageClient:
+    """Clean Voyage AI client using official SDK."""
+    
+    def __init__(self, api_key: str, model: str = "voyage-code-2"):
+        self.api_key = api_key
+        self.model = model
+        self._embedding_dimension: int | None = None
+        
+        # Initialize official Voyage AI client
+        self.client = voyageai.Client(api_key=api_key)
+        logger.info(f"Initialized Voyage AI client with model {model}")
+    
+    def health_check(self) -> bool:
+        """Check if Voyage AI service is healthy."""
+        try:
+            result = self.client.embed(["test"], model=self.model, input_type="query")
+            return len(result.embeddings) > 0
+        except Exception as e:
+            logger.warning(f"Voyage AI health check failed: {e}")
+            return False
+    
+    def generate_embeddings(
+        self,
+        texts: List[str],
+        input_type: str = "document",
+        **kwargs
+    ) -> List[List[float]]:
+        """Generate embeddings for texts using official SDK."""
+        if not texts:
+            return []
+        
+        logger.info(f"Generating embeddings for {len(texts)} texts using {self.model}")
+        
+        try:
+            result = self.client.embed(
+                texts=texts,
+                model=self.model,
+                input_type=input_type,
+                truncation=True
+            )
+            
+            # Log usage if available
+            if hasattr(result, 'usage') and result.usage:
+                logger.debug(f"Token usage: {result.usage.total_tokens}")
+            
+            logger.info(f"Successfully generated {len(result.embeddings)} embeddings")
+            return result.embeddings
+            
+        except Exception as e:
+            logger.error(f"Failed to generate embeddings: {e}")
+            raise RuntimeError(f"Embedding generation failed: {e}")
+    
+    def get_embedding_dimension(self) -> int:
+        """Get the dimension of embeddings produced by this model."""
+        if self._embedding_dimension is not None:
+            return self._embedding_dimension
+        
+        # Generate a test embedding to determine dimension
+        try:
+            test_embeddings = self.generate_embeddings(["test"], input_type="query")
+            if test_embeddings:
+                self._embedding_dimension = len(test_embeddings[0])
+                logger.info(f"Detected embedding dimension: {self._embedding_dimension}")
+                return self._embedding_dimension
+        except Exception as e:
+            logger.warning(f"Could not determine embedding dimension: {e}")
+        
+        # Default dimensions for known Voyage models
+        model_dimensions = {
+            "voyage-code-2": 1536,
+            "voyage-2": 1024,
+            "voyage-large-2": 1536,
+            "voyage-3": 1024,
+        }
+        
+        self._embedding_dimension = model_dimensions.get(self.model, 1536)
+        logger.info(f"Using default embedding dimension: {self._embedding_dimension}")
+        return self._embedding_dimension
+    
+    def estimate_cost(self, texts: List[str]) -> Dict[str, Any]:
+        """Estimate the cost of embedding generation."""
+        # Rough token estimation (4 chars per token)
+        total_tokens = sum(len(text) // 4 for text in texts)
+        
+        # Voyage AI pricing (approximate, may change)
+        cost_per_1k_tokens = 0.00013  # voyage-code-2 pricing
+        estimated_cost = (total_tokens / 1000) * cost_per_1k_tokens
+        
+        return {
+            "total_tokens": total_tokens,
+            "total_texts": len(texts),
+            "estimated_cost_usd": round(estimated_cost, 6),
+            "model": self.model,
+        }
+
+def create_voyage_client(config: VectorConfig) -> VoyageClient:
+    """Create a Voyage client from configuration."""
+    if not config.voyage_api_key:
+        raise ValueError("VOYAGE_API_KEY is required for embedding generation")
+    
+    return VoyageClient(
+        api_key=config.voyage_api_key,
+        model=config.embedding_model,
+    )

mcp_code_indexer-4.1.0/src/mcp_code_indexer/vector_mode/providers/__init__.py

@@ -1,72 +0,0 @@
-"""
-External service providers for vector mode.
-
-This package provides integrations with external services including:
-- Voyage AI for embedding generation
-- Turbopuffer for vector storage and search
-"""
-
-from typing import Protocol, List, Dict, Any, Optional
-from abc import abstractmethod
-
-class EmbeddingProvider(Protocol):
-    """Protocol for embedding generation providers."""
-    
-    @abstractmethod
-    async def generate_embeddings(
-        self,
-        texts: List[str],
-        input_type: str = "document",
-        **kwargs
-    ) -> List[List[float]]:
-        """Generate embeddings for a list of texts."""
-        ...
-    
-    @abstractmethod
-    async def get_embedding_dimension(self) -> int:
-        """Get the dimension of embeddings produced by this provider."""
-        ...
-
-class VectorStoreProvider(Protocol):
-    """Protocol for vector storage providers."""
-    
-    @abstractmethod
-    async def upsert_vectors(
-        self,
-        vectors: List[Dict[str, Any]],
-        namespace: Optional[str] = None,
-        **kwargs
-    ) -> Dict[str, Any]:
-        """Store or update vectors in the database."""
-        ...
-    
-    @abstractmethod
-    async def search_vectors(
-        self,
-        query_vector: List[float],
-        top_k: int = 10,
-        namespace: Optional[str] = None,
-        filters: Optional[Dict[str, Any]] = None,
-        **kwargs
-    ) -> List[Dict[str, Any]]:
-        """Search for similar vectors."""
-        ...
-    
-    @abstractmethod
-    async def delete_vectors(
-        self,
-        vector_ids: List[str],
-        namespace: Optional[str] = None,
-        **kwargs
-    ) -> Dict[str, Any]:
-        """Delete vectors by ID."""
-        ...
-    
-    @abstractmethod
-    async def get_namespace_stats(
-        self,
-        namespace: Optional[str] = None,
-        **kwargs
-    ) -> Dict[str, Any]:
-        """Get statistics about a namespace."""
-        ...