feat(vectordb): Add database-agnostic vector search abstraction

docs/v1/qdrant.md

@@ -19,7 +19,7 @@ Core Features:
 - Vector similarity search with abstracted SearchResult interface
 - Type\-safe collection creation and existence checks
 - Support for payload metadata and optional vector retrieval
-- Extensible abstraction layer for alternate vector stores \(e.g., Pinecone, Postgres\)
+- Extensible abstraction layer for alternate vector stores \(e.g. pgVector\)
 
 Basic Usage:
 

v1/qdrant/client.go

@@ -97,6 +97,10 @@ func NewQdrantClient(p QdrantParams) (*QdrantClient, error) {
 //
 // It should be lightweight and fast — typically used during startup or readiness probes.
 func (c *QdrantClient) healthCheck() error {
+	if !c.started {
+		return fmt.Errorf("[Qdrant] client not started")
+	}
+
 	ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
 	defer cancel()
 
@@ -114,15 +118,25 @@ func (c *QdrantClient) healthCheck() error {
 	return nil
 }
 
+// Client returns the underlying Qdrant SDK client.
+// This is useful for direct access to low-level operations.
+func (c *QdrantClient) Client() *qdrant.Client {
+	return c.api
+}
+
 // Close ──────────────────────────────────────────────────────────────
 // Close
 // ──────────────────────────────────────────────────────────────
 //
 // Close gracefully shuts down the Qdrant client.
 //
-// Since the official Qdrant Go SDK doesn’t maintain persistent connections,
+// Since the official Qdrant Go SDK doesn't maintain persistent connections,
 // this is currently a no-op. It exists for lifecycle symmetry and future safety.
 func (c *QdrantClient) Close() error {
+	if !c.started {
+		return nil
+	}
+
 	log.Println("[Qdrant] closing client (no-op)")
 	return nil
 }

v1/qdrant/configs.go

@@ -31,6 +31,12 @@ type Config struct {
 	// Optional authentication token for secured deployments.
 	ApiKey string `yaml:"api_key" env:"QDRANT_API_KEY"`
 
+	// ────────────────────────────────────────────────────────────────────────────
+	// Connection Settings
+	// ────────────────────────────────────────────────────────────────────────────
+	// Note: The following fields are reserved for future use.
+	// They are not currently passed to the Qdrant SDK client.
+
 	// Maximum request duration before timing out.
 	Timeout time.Duration `yaml:"timeout" env:"QDRANT_TIMEOUT"`