@retrivora-ai/rag-engine 0.1.6 → 0.1.7

package/dist/{QdrantProvider-NYGHAA7C.mjs → QdrantProvider-VAED5VA7.mjs}

@@ -1,6 +1,6 @@
 import {
   QdrantProvider
-} from "./chunk-5K23H7JL.mjs";
+} from "./chunk-CWQQHAF6.mjs";
 import "./chunk-VOIWNO5O.mjs";
 import "./chunk-I4E63NIC.mjs";
 export {

package/dist/{chunk-HSBXE2WV.mjs → chunk-7YQWGERZ.mjs}

@@ -67,6 +67,7 @@ function getRagConfig(env = process.env) {
   } else if (vectorProvider === "qdrant") {
     vectorDbOptions.baseUrl = (_m = readString(env, "QDRANT_URL")) != null ? _m : "http://localhost:6333";
     vectorDbOptions.apiKey = readString(env, "QDRANT_API_KEY");
+    vectorDbOptions.dimensions = embeddingDimensions;
   }
   const llmApiKeyByProvider = {
     openai: readString(env, "OPENAI_API_KEY"),
@@ -603,9 +604,11 @@ var ConfigValidator = class {
     return errors;
   }
   static isValidCSSColor(color) {
-    const s = new Option().style;
-    s.color = color;
-    return s.color !== "";
+    const hexRegex = /^#([0-9a-f]{3}){1,2}$/i;
+    const rgbRegex = /^rgba?\((\d+),\s*(\d+),\s*(\d+)(?:,\s*(\d+(?:\.\d+)?))?\)$/i;
+    const hslRegex = /^hsla?\((\d+),\s*(\d+)%,\s*(\d+)%(?:,\s*(\d+(?:\.\d+)?))?\)$/i;
+    const namedColors = ["red", "blue", "green", "black", "white", "transparent"];
+    return hexRegex.test(color) || rgbRegex.test(color) || hslRegex.test(color) || namedColors.includes(color.toLowerCase());
   }
   /**
    * Throws if there are error-level validation issues.
@@ -720,7 +723,7 @@ var ProviderRegistry = class {
         const { MilvusProvider } = await import("./MilvusProvider-OO6QGZDZ.mjs");
         return new MilvusProvider(config);
       case "qdrant":
-        const { QdrantProvider } = await import("./QdrantProvider-NYGHAA7C.mjs");
+        const { QdrantProvider } = await import("./QdrantProvider-VAED5VA7.mjs");
         return new QdrantProvider(config);
       case "chromadb":
         const { ChromaDBProvider } = await import("./ChromaDBProvider-QNI7UCX4.mjs");
@@ -1261,7 +1264,10 @@ var ProviderHealthCheck = class {
     const opts = config.options;
     const baseUrl = opts.baseUrl || opts.url || "http://localhost:6333";
     try {
-      const response = await fetch(`${baseUrl}/health`);
+      const apiKey = opts.apiKey;
+      const response = await fetch(`${baseUrl}/`, {
+        headers: apiKey ? { "api-key": apiKey } : {}
+      });
       if (!response.ok) {
         throw new Error(`Health check returned ${response.status}`);
       }

package/dist/{chunk-5K23H7JL.mjs → chunk-CWQQHAF6.mjs}

@@ -7,6 +7,7 @@ import {
 
 // src/providers/vectordb/QdrantProvider.ts
 import axios from "axios";
+import crypto from "crypto";
 var QdrantProvider = class extends BaseVectorProvider {
   constructor(config) {
     super(config);
@@ -22,8 +23,36 @@ var QdrantProvider = class extends BaseVectorProvider {
   }
   async initialize() {
     await this.ping();
+    await this.ensureCollection();
     await this.ensureIndex();
   }
+  /**
+   * Ensures the collection exists. Creates it if missing.
+   */
+  async ensureCollection() {
+    var _a;
+    try {
+      const opts = this.config.options;
+      const dimensions = opts.dimensions || 1536;
+      await this.http.get(`/collections/${this.indexName}`);
+      console.log(`[QdrantProvider] \u2705 Collection "${this.indexName}" already exists.`);
+    } catch (err) {
+      if (axios.isAxiosError(err) && ((_a = err.response) == null ? void 0 : _a.status) === 404) {
+        const opts = this.config.options;
+        const dimensions = opts.dimensions || 1536;
+        console.log(`[QdrantProvider] \u23F3 Creating collection "${this.indexName}" (dimensions: ${dimensions})...`);
+        await this.http.put(`/collections/${this.indexName}`, {
+          vectors: {
+            size: dimensions,
+            distance: "Cosine"
+          }
+        });
+        console.log(`[QdrantProvider] \u2705 Created collection "${this.indexName}"`);
+      } else {
+        throw err;
+      }
+    }
+  }
   /**
    * Ensures that the 'namespace' field has a keyword index for efficient filtering.
    * Qdrant requires this for search filters to work in many configurations.
@@ -56,7 +85,7 @@ var QdrantProvider = class extends BaseVectorProvider {
   async batchUpsert(docs, namespace) {
     const payload = {
       points: docs.map((doc) => ({
-        id: doc.id,
+        id: this.normalizeId(doc.id),
         vector: doc.vector,
         payload: __spreadValues({
           content: doc.content,
@@ -90,7 +119,7 @@ var QdrantProvider = class extends BaseVectorProvider {
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   async delete(id, _namespace) {
     await this.http.post(`/collections/${this.indexName}/points/delete`, {
-      points: [id]
+      points: [this.normalizeId(id)]
     });
   }
   async deleteNamespace(_namespace) {
@@ -108,6 +137,17 @@ var QdrantProvider = class extends BaseVectorProvider {
       return false;
     }
   }
+  /**
+   * Normalizes an ID into a format Qdrant accepts (UUID or integer).
+   * For string IDs that aren't UUIDs, it generates a deterministic UUID v5-like hash.
+   */
+  normalizeId(id) {
+    if (typeof id === "number") return id;
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (uuidRegex.test(id)) return id.toLowerCase();
+    const hash = crypto.createHash("md5").update(id).digest("hex");
+    return `${hash.slice(0, 8)}-${hash.slice(8, 12)}-${hash.slice(12, 16)}-${hash.slice(16, 20)}-${hash.slice(20, 32)}`;
+  }
   async disconnect() {
   }
 };

package/dist/handlers/index.js

@@ -955,11 +955,12 @@ var QdrantProvider_exports = {};
 __export(QdrantProvider_exports, {
   QdrantProvider: () => QdrantProvider
 });
-var import_axios4, QdrantProvider;
+var import_axios4, import_crypto, QdrantProvider;
 var init_QdrantProvider = __esm({
   "src/providers/vectordb/QdrantProvider.ts"() {
     "use strict";
     import_axios4 = __toESM(require("axios"));
+    import_crypto = __toESM(require("crypto"));
     init_BaseVectorProvider();
     QdrantProvider = class extends BaseVectorProvider {
       constructor(config) {
@@ -976,8 +977,36 @@ var init_QdrantProvider = __esm({
       }
       async initialize() {
         await this.ping();
+        await this.ensureCollection();
         await this.ensureIndex();
       }
+      /**
+       * Ensures the collection exists. Creates it if missing.
+       */
+      async ensureCollection() {
+        var _a;
+        try {
+          const opts = this.config.options;
+          const dimensions = opts.dimensions || 1536;
+          await this.http.get(`/collections/${this.indexName}`);
+          console.log(`[QdrantProvider] \u2705 Collection "${this.indexName}" already exists.`);
+        } catch (err) {
+          if (import_axios4.default.isAxiosError(err) && ((_a = err.response) == null ? void 0 : _a.status) === 404) {
+            const opts = this.config.options;
+            const dimensions = opts.dimensions || 1536;
+            console.log(`[QdrantProvider] \u23F3 Creating collection "${this.indexName}" (dimensions: ${dimensions})...`);
+            await this.http.put(`/collections/${this.indexName}`, {
+              vectors: {
+                size: dimensions,
+                distance: "Cosine"
+              }
+            });
+            console.log(`[QdrantProvider] \u2705 Created collection "${this.indexName}"`);
+          } else {
+            throw err;
+          }
+        }
+      }
       /**
        * Ensures that the 'namespace' field has a keyword index for efficient filtering.
        * Qdrant requires this for search filters to work in many configurations.
@@ -1010,7 +1039,7 @@ var init_QdrantProvider = __esm({
       async batchUpsert(docs, namespace) {
         const payload = {
           points: docs.map((doc) => ({
-            id: doc.id,
+            id: this.normalizeId(doc.id),
             vector: doc.vector,
             payload: __spreadValues({
               content: doc.content,
@@ -1044,7 +1073,7 @@ var init_QdrantProvider = __esm({
       // eslint-disable-next-line @typescript-eslint/no-unused-vars
       async delete(id, _namespace) {
         await this.http.post(`/collections/${this.indexName}/points/delete`, {
-          points: [id]
+          points: [this.normalizeId(id)]
         });
       }
       async deleteNamespace(_namespace) {
@@ -1062,6 +1091,17 @@ var init_QdrantProvider = __esm({
           return false;
         }
       }
+      /**
+       * Normalizes an ID into a format Qdrant accepts (UUID or integer).
+       * For string IDs that aren't UUIDs, it generates a deterministic UUID v5-like hash.
+       */
+      normalizeId(id) {
+        if (typeof id === "number") return id;
+        const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+        if (uuidRegex.test(id)) return id.toLowerCase();
+        const hash = import_crypto.default.createHash("md5").update(id).digest("hex");
+        return `${hash.slice(0, 8)}-${hash.slice(8, 12)}-${hash.slice(12, 16)}-${hash.slice(16, 20)}-${hash.slice(20, 32)}`;
+      }
       async disconnect() {
       }
     };
@@ -1418,6 +1458,7 @@ function getRagConfig(env = process.env) {
   } else if (vectorProvider === "qdrant") {
     vectorDbOptions.baseUrl = (_m = readString(env, "QDRANT_URL")) != null ? _m : "http://localhost:6333";
     vectorDbOptions.apiKey = readString(env, "QDRANT_API_KEY");
+    vectorDbOptions.dimensions = embeddingDimensions;
   }
   const llmApiKeyByProvider = {
     openai: readString(env, "OPENAI_API_KEY"),
@@ -1954,9 +1995,11 @@ var ConfigValidator = class {
     return errors;
   }
   static isValidCSSColor(color) {
-    const s = new Option().style;
-    s.color = color;
-    return s.color !== "";
+    const hexRegex = /^#([0-9a-f]{3}){1,2}$/i;
+    const rgbRegex = /^rgba?\((\d+),\s*(\d+),\s*(\d+)(?:,\s*(\d+(?:\.\d+)?))?\)$/i;
+    const hslRegex = /^hsla?\((\d+),\s*(\d+)%,\s*(\d+)%(?:,\s*(\d+(?:\.\d+)?))?\)$/i;
+    const namedColors = ["red", "blue", "green", "black", "white", "transparent"];
+    return hexRegex.test(color) || rgbRegex.test(color) || hslRegex.test(color) || namedColors.includes(color.toLowerCase());
   }
   /**
    * Throws if there are error-level validation issues.
@@ -2613,7 +2656,10 @@ var ProviderHealthCheck = class {
     const opts = config.options;
     const baseUrl = opts.baseUrl || opts.url || "http://localhost:6333";
     try {
-      const response = await fetch(`${baseUrl}/health`);
+      const apiKey = opts.apiKey;
+      const response = await fetch(`${baseUrl}/`, {
+        headers: apiKey ? { "api-key": apiKey } : {}
+      });
       if (!response.ok) {
         throw new Error(`Health check returned ${response.status}`);
       }

package/dist/handlers/index.mjs

@@ -3,7 +3,7 @@ import {
   createHealthHandler,
   createIngestHandler,
   createUploadHandler
-} from "../chunk-HSBXE2WV.mjs";
+} from "../chunk-7YQWGERZ.mjs";
 import "../chunk-JI6VD5TJ.mjs";
 import "../chunk-UKDXCXW7.mjs";
 import "../chunk-I4E63NIC.mjs";

package/dist/server.d.mts

@@ -266,6 +266,10 @@ declare class QdrantProvider extends BaseVectorProvider {
     private http;
     constructor(config: VectorDBConfig);
     initialize(): Promise<void>;
+    /**
+     * Ensures the collection exists. Creates it if missing.
+     */
+    private ensureCollection;
     /**
      * Ensures that the 'namespace' field has a keyword index for efficient filtering.
      * Qdrant requires this for search filters to work in many configurations.
@@ -277,6 +281,11 @@ declare class QdrantProvider extends BaseVectorProvider {
     delete(id: string | number, _namespace?: string): Promise<void>;
     deleteNamespace(_namespace: string): Promise<void>;
     ping(): Promise<boolean>;
+    /**
+     * Normalizes an ID into a format Qdrant accepts (UUID or integer).
+     * For string IDs that aren't UUIDs, it generates a deterministic UUID v5-like hash.
+     */
+    private normalizeId;
     disconnect(): Promise<void>;
 }
 

package/dist/server.d.ts

@@ -266,6 +266,10 @@ declare class QdrantProvider extends BaseVectorProvider {
     private http;
     constructor(config: VectorDBConfig);
     initialize(): Promise<void>;
+    /**
+     * Ensures the collection exists. Creates it if missing.
+     */
+    private ensureCollection;
     /**
      * Ensures that the 'namespace' field has a keyword index for efficient filtering.
      * Qdrant requires this for search filters to work in many configurations.
@@ -277,6 +281,11 @@ declare class QdrantProvider extends BaseVectorProvider {
     delete(id: string | number, _namespace?: string): Promise<void>;
     deleteNamespace(_namespace: string): Promise<void>;
     ping(): Promise<boolean>;
+    /**
+     * Normalizes an ID into a format Qdrant accepts (UUID or integer).
+     * For string IDs that aren't UUIDs, it generates a deterministic UUID v5-like hash.
+     */
+    private normalizeId;
     disconnect(): Promise<void>;
 }
 

package/dist/server.js

@@ -955,11 +955,12 @@ var QdrantProvider_exports = {};
 __export(QdrantProvider_exports, {
   QdrantProvider: () => QdrantProvider
 });
-var import_axios4, QdrantProvider;
+var import_axios4, import_crypto, QdrantProvider;
 var init_QdrantProvider = __esm({
   "src/providers/vectordb/QdrantProvider.ts"() {
     "use strict";
     import_axios4 = __toESM(require("axios"));
+    import_crypto = __toESM(require("crypto"));
     init_BaseVectorProvider();
     QdrantProvider = class extends BaseVectorProvider {
       constructor(config) {
@@ -976,8 +977,36 @@ var init_QdrantProvider = __esm({
       }
       async initialize() {
         await this.ping();
+        await this.ensureCollection();
         await this.ensureIndex();
       }
+      /**
+       * Ensures the collection exists. Creates it if missing.
+       */
+      async ensureCollection() {
+        var _a;
+        try {
+          const opts = this.config.options;
+          const dimensions = opts.dimensions || 1536;
+          await this.http.get(`/collections/${this.indexName}`);
+          console.log(`[QdrantProvider] \u2705 Collection "${this.indexName}" already exists.`);
+        } catch (err) {
+          if (import_axios4.default.isAxiosError(err) && ((_a = err.response) == null ? void 0 : _a.status) === 404) {
+            const opts = this.config.options;
+            const dimensions = opts.dimensions || 1536;
+            console.log(`[QdrantProvider] \u23F3 Creating collection "${this.indexName}" (dimensions: ${dimensions})...`);
+            await this.http.put(`/collections/${this.indexName}`, {
+              vectors: {
+                size: dimensions,
+                distance: "Cosine"
+              }
+            });
+            console.log(`[QdrantProvider] \u2705 Created collection "${this.indexName}"`);
+          } else {
+            throw err;
+          }
+        }
+      }
       /**
        * Ensures that the 'namespace' field has a keyword index for efficient filtering.
        * Qdrant requires this for search filters to work in many configurations.
@@ -1010,7 +1039,7 @@ var init_QdrantProvider = __esm({
       async batchUpsert(docs, namespace) {
         const payload = {
           points: docs.map((doc) => ({
-            id: doc.id,
+            id: this.normalizeId(doc.id),
             vector: doc.vector,
             payload: __spreadValues({
               content: doc.content,
@@ -1044,7 +1073,7 @@ var init_QdrantProvider = __esm({
       // eslint-disable-next-line @typescript-eslint/no-unused-vars
       async delete(id, _namespace) {
         await this.http.post(`/collections/${this.indexName}/points/delete`, {
-          points: [id]
+          points: [this.normalizeId(id)]
         });
       }
       async deleteNamespace(_namespace) {
@@ -1062,6 +1091,17 @@ var init_QdrantProvider = __esm({
           return false;
         }
       }
+      /**
+       * Normalizes an ID into a format Qdrant accepts (UUID or integer).
+       * For string IDs that aren't UUIDs, it generates a deterministic UUID v5-like hash.
+       */
+      normalizeId(id) {
+        if (typeof id === "number") return id;
+        const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+        if (uuidRegex.test(id)) return id.toLowerCase();
+        const hash = import_crypto.default.createHash("md5").update(id).digest("hex");
+        return `${hash.slice(0, 8)}-${hash.slice(8, 12)}-${hash.slice(12, 16)}-${hash.slice(16, 20)}-${hash.slice(20, 32)}`;
+      }
       async disconnect() {
       }
     };
@@ -1436,6 +1476,7 @@ function getRagConfig(env = process.env) {
   } else if (vectorProvider === "qdrant") {
     vectorDbOptions.baseUrl = (_m = readString(env, "QDRANT_URL")) != null ? _m : "http://localhost:6333";
     vectorDbOptions.apiKey = readString(env, "QDRANT_API_KEY");
+    vectorDbOptions.dimensions = embeddingDimensions;
   }
   const llmApiKeyByProvider = {
     openai: readString(env, "OPENAI_API_KEY"),
@@ -1972,9 +2013,11 @@ var ConfigValidator = class {
     return errors;
   }
   static isValidCSSColor(color) {
-    const s = new Option().style;
-    s.color = color;
-    return s.color !== "";
+    const hexRegex = /^#([0-9a-f]{3}){1,2}$/i;
+    const rgbRegex = /^rgba?\((\d+),\s*(\d+),\s*(\d+)(?:,\s*(\d+(?:\.\d+)?))?\)$/i;
+    const hslRegex = /^hsla?\((\d+),\s*(\d+)%,\s*(\d+)%(?:,\s*(\d+(?:\.\d+)?))?\)$/i;
+    const namedColors = ["red", "blue", "green", "black", "white", "transparent"];
+    return hexRegex.test(color) || rgbRegex.test(color) || hslRegex.test(color) || namedColors.includes(color.toLowerCase());
   }
   /**
    * Throws if there are error-level validation issues.
@@ -2631,7 +2674,10 @@ var ProviderHealthCheck = class {
     const opts = config.options;
     const baseUrl = opts.baseUrl || opts.url || "http://localhost:6333";
     try {
-      const response = await fetch(`${baseUrl}/health`);
+      const apiKey = opts.apiKey;
+      const response = await fetch(`${baseUrl}/`, {
+        headers: apiKey ? { "api-key": apiKey } : {}
+      });
       if (!response.ok) {
         throw new Error(`Health check returned ${response.status}`);
       }

package/dist/server.mjs

@@ -1,6 +1,6 @@
 import {
   QdrantProvider
-} from "./chunk-5K23H7JL.mjs";
+} from "./chunk-CWQQHAF6.mjs";
 import {
   ChromaDBProvider
 } from "./chunk-HUGLYKD6.mjs";
@@ -21,7 +21,7 @@ import {
   createIngestHandler,
   createUploadHandler,
   getRagConfig
-} from "./chunk-HSBXE2WV.mjs";
+} from "./chunk-7YQWGERZ.mjs";
 import {
   AnthropicProvider,
   LLMFactory,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retrivora-ai/rag-engine",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Retrivora AI is a plug-and-play AI engine for RAG chat experiences — generic vector DB + LLM provider, embeddable or standalone.",
   "author": "Abhinav Alkuchi",
   "license": "MIT",

package/src/config/serverConfig.ts

@@ -76,6 +76,7 @@ export function getRagConfig(env: Record<string, string | undefined> = process.e
   } else if (vectorProvider === 'qdrant') {
     vectorDbOptions.baseUrl = readString(env, 'QDRANT_URL') ?? 'http://localhost:6333';
     vectorDbOptions.apiKey = readString(env, 'QDRANT_API_KEY');
+    vectorDbOptions.dimensions = embeddingDimensions;
   }
 
   const llmApiKeyByProvider: Record<string, string | undefined> = {

package/src/core/ConfigValidator.ts

@@ -526,10 +526,18 @@ export class ConfigValidator {
   }
 
   private static isValidCSSColor(color: string): boolean {
-    // Check if valid CSS color
-    const s = new Option().style;
-    s.color = color;
-    return s.color !== '';
+    // Basic regex for hex, rgb, rgba, hsl, hsla
+    const hexRegex = /^#([0-9a-f]{3}){1,2}$/i;
+    const rgbRegex = /^rgba?\((\d+),\s*(\d+),\s*(\d+)(?:,\s*(\d+(?:\.\d+)?))?\)$/i;
+    const hslRegex = /^hsla?\((\d+),\s*(\d+)%,\s*(\d+)%(?:,\s*(\d+(?:\.\d+)?))?\)$/i;
+    const namedColors = ['red', 'blue', 'green', 'black', 'white', 'transparent']; // basic set
+
+    return (
+      hexRegex.test(color) ||
+      rgbRegex.test(color) ||
+      hslRegex.test(color) ||
+      namedColors.includes(color.toLowerCase())
+    );
   }
 
   /**

package/src/core/ProviderHealthCheck.ts

@@ -235,7 +235,10 @@ export class ProviderHealthCheck {
     const baseUrl = (opts.baseUrl as string) || (opts.url as string) || 'http://localhost:6333';
 
     try {
-      const response = await fetch(`${baseUrl}/health`);
+      const apiKey = opts.apiKey as string | undefined;
+      const response = await fetch(`${baseUrl}/`, {
+        headers: apiKey ? { 'api-key': apiKey } : {},
+      });
       
       if (!response.ok) {
         throw new Error(`Health check returned ${response.status}`);

package/src/providers/vectordb/QdrantProvider.ts

@@ -1,4 +1,5 @@
 import axios, { AxiosInstance } from 'axios';
+import crypto from 'crypto';
 import { VectorDBConfig } from '../../config/RagConfig';
 import { BaseVectorProvider } from './BaseVectorProvider';
 import { VectorMatch, UpsertDocument } from '../../types';
@@ -26,9 +27,39 @@ export class QdrantProvider extends BaseVectorProvider {
 
   async initialize(): Promise<void> {
     await this.ping();
+    await this.ensureCollection();
     await this.ensureIndex();
   }
 
+  /**
+   * Ensures the collection exists. Creates it if missing.
+   */
+  private async ensureCollection(): Promise<void> {
+    try {
+      const opts = this.config.options as Record<string, unknown>;
+      const dimensions = (opts.dimensions as number) || 1536;
+
+      await this.http.get(`/collections/${this.indexName}`);
+      console.log(`[QdrantProvider] ✅ Collection "${this.indexName}" already exists.`);
+    } catch (err) {
+      if (axios.isAxiosError(err) && err.response?.status === 404) {
+        const opts = this.config.options as Record<string, unknown>;
+        const dimensions = (opts.dimensions as number) || 1536;
+
+        console.log(`[QdrantProvider] ⏳ Creating collection "${this.indexName}" (dimensions: ${dimensions})...`);
+        await this.http.put(`/collections/${this.indexName}`, {
+          vectors: {
+            size: dimensions,
+            distance: 'Cosine',
+          },
+        });
+        console.log(`[QdrantProvider] ✅ Created collection "${this.indexName}"`);
+      } else {
+        throw err;
+      }
+    }
+  }
+
   /**
    * Ensures that the 'namespace' field has a keyword index for efficient filtering.
    * Qdrant requires this for search filters to work in many configurations.
@@ -66,7 +97,7 @@ export class QdrantProvider extends BaseVectorProvider {
   async batchUpsert(docs: UpsertDocument[], namespace?: string): Promise<void> {
     const payload = {
       points: docs.map(doc => ({
-        id: doc.id,
+        id: this.normalizeId(doc.id),
         vector: doc.vector,
         payload: {
           content: doc.content,
@@ -100,7 +131,7 @@ export class QdrantProvider extends BaseVectorProvider {
   // eslint-disable-next-line @typescript-eslint/no-unused-vars
   async delete(id: string | number, _namespace?: string): Promise<void> {
     await this.http.post(`/collections/${this.indexName}/points/delete`, {
-      points: [id],
+      points: [this.normalizeId(id)],
     });
   }
 
@@ -121,5 +152,21 @@ export class QdrantProvider extends BaseVectorProvider {
     }
   }
 
+  /**
+   * Normalizes an ID into a format Qdrant accepts (UUID or integer).
+   * For string IDs that aren't UUIDs, it generates a deterministic UUID v5-like hash.
+   */
+  private normalizeId(id: string | number): string | number {
+    if (typeof id === 'number') return id;
+    
+    // Check if already a valid UUID
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+    if (uuidRegex.test(id)) return id.toLowerCase();
+
+    // Hash string to deterministic UUID
+    const hash = crypto.createHash('md5').update(id).digest('hex');
+    return `${hash.slice(0, 8)}-${hash.slice(8, 12)}-${hash.slice(12, 16)}-${hash.slice(16, 20)}-${hash.slice(20, 32)}`;
+  }
+
   async disconnect(): Promise<void> {}
 }