@debian777/kairos-mcp 3.0.1-beta.14

package/dist/utils/qdrant-collection-utils.d.ts

@@ -0,0 +1,11 @@
+import { QdrantClient } from '@qdrant/js-client-rest';
+import { VectorDescriptorMap } from './qdrant-vector-types.js';
+/**
+ * Create a Qdrant collection with standard vector configuration
+ */
+export declare function createQdrantCollection(client: QdrantClient, collectionName: string, vectors?: VectorDescriptorMap): Promise<void>;
+/**
+ * Get the current vector size of an existing collection
+ */
+export declare function getCollectionVectorConfig(client: QdrantClient, collectionName: string): Promise<VectorDescriptorMap | number | null>;
+//# sourceMappingURL=qdrant-collection-utils.d.ts.map

package/dist/utils/qdrant-collection-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-collection-utils.d.ts","sourceRoot":"","sources":["../../src/utils/qdrant-collection-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAwB,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAErF;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BvI;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,MAAM,GAAG,IAAI,CAAC,CAqB1I"}

package/dist/utils/qdrant-collection-utils.js

@@ -0,0 +1,62 @@
+import { getVectorDescriptors } from './qdrant-vector-types.js';
+/**
+ * Create a Qdrant collection with standard vector configuration
+ */
+export async function createQdrantCollection(client, collectionName, vectors) {
+    // If caller provided explicit vector descriptors, use them, otherwise generate defaults
+    const vecs = vectors || getVectorDescriptors();
+    // Normalize to Qdrant expected shape: either single vector or named vectors
+    let vectorConfig;
+    const keys = Object.keys(vecs);
+    if (keys.length === 1 && keys[0] === 'oai') {
+        // Backwards compatibility: single vector under root
+        const oaiVec = vecs['oai'];
+        if (oaiVec) {
+            vectorConfig = { size: oaiVec.size, distance: oaiVec.distance || 'Cosine', on_disk: oaiVec.on_disk };
+        }
+    }
+    else {
+        // Named vectors
+        vectorConfig = {};
+        Object.entries(vecs).forEach(([k, v]) => {
+            vectorConfig[k] = { size: v.size, distance: v.distance || 'Cosine', on_disk: v.on_disk };
+        });
+    }
+    await client.createCollection(collectionName, {
+        vectors: vectorConfig,
+        quantization_config: {
+            scalar: {
+                type: "int8",
+                always_ram: true,
+            },
+        },
+    });
+}
+/**
+ * Get the current vector size of an existing collection
+ */
+export async function getCollectionVectorConfig(client, collectionName) {
+    try {
+        const collectionInfo = await client.getCollection(collectionName);
+        const vectors = collectionInfo.config?.params?.vectors;
+        if (!vectors)
+            return null;
+        // If named vectors exist, parse named map
+        if (typeof vectors === 'object' && !('size' in vectors)) {
+            const out = {};
+            Object.entries(vectors).forEach(([k, v]) => {
+                out[k] = { size: v.size, distance: v.distance || 'Cosine', on_disk: v.on_disk };
+            });
+            return out;
+        }
+        if (typeof vectors === 'object' && 'size' in vectors) {
+            // Single vector configured (legacy)
+            return vectors.size;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=qdrant-collection-utils.js.map

package/dist/utils/qdrant-collection-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-collection-utils.js","sourceRoot":"","sources":["../../src/utils/qdrant-collection-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAuB,MAAM,0BAA0B,CAAC;AAErF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,MAAoB,EAAE,cAAsB,EAAE,OAA6B;IACtH,wFAAwF;IACxF,MAAM,IAAI,GAAG,OAAO,IAAI,oBAAoB,EAAE,CAAC;IAC/C,4EAA4E;IAC5E,IAAI,YAAiB,CAAC;IACtB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;QAC3C,oDAAoD;QACpD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,MAAM,EAAE,CAAC;YACX,YAAY,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QACvG,CAAC;IACH,CAAC;SAAM,CAAC;QACN,gBAAgB;QAChB,YAAY,GAAG,EAAS,CAAC;QACzB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;YACtC,YAAY,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;QAC3F,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE;QAC5C,OAAO,EAAE,YAAY;QACrB,mBAAmB,EAAE;YACnB,MAAM,EAAE;gBACN,IAAI,EAAE,MAAM;gBACZ,UAAU,EAAE,IAAI;aACjB;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,MAAoB,EAAE,cAAsB;IAC1F,IAAI,CAAC;QACH,MAAM,cAAc,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;QACvD,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC1B,0CAA0C;QAC1C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC;YACxD,MAAM,GAAG,GAAwB,EAAE,CAAC;YACpC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAgB,EAAE,EAAE;gBACxD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;YAClF,CAAC,CAAC,CAAC;YACH,OAAO,GAAG,CAAC;QACb,CAAC;QACD,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,MAAM,IAAI,OAAO,EAAE,CAAC;YACrD,oCAAoC;YACpC,OAAQ,OAAe,CAAC,IAAI,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/utils/qdrant-query-utils.d.ts

@@ -0,0 +1,6 @@
+import { QdrantClient } from '@qdrant/js-client-rest';
+/**
+ * Count points that have the specified named vector present (non-null)
+ */
+export declare function countPointsWithVector(client: QdrantClient, collectionName: string, vectorName: string): Promise<number>;
+//# sourceMappingURL=qdrant-query-utils.d.ts.map

package/dist/utils/qdrant-query-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-query-utils.d.ts","sourceRoot":"","sources":["../../src/utils/qdrant-query-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAItD;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAe7H"}

package/dist/utils/qdrant-query-utils.js

@@ -0,0 +1,23 @@
+import { getSpaceContext } from './tenant-context.js';
+import { buildSpaceFilter } from './space-filter.js';
+/**
+ * Count points that have the specified named vector present (non-null)
+ */
+export async function countPointsWithVector(client, collectionName, vectorName) {
+    const filter = buildSpaceFilter(getSpaceContext().allowedSpaceIds);
+    let offset = undefined;
+    let count = 0;
+    do {
+        const page = await client.scroll(collectionName, { filter, with_payload: false, with_vector: [vectorName], limit: 256, offset });
+        if (!page?.points || page.points.length === 0)
+            break;
+        for (const p of page.points) {
+            if (p?.vector && p.vector[vectorName]) {
+                count += 1;
+            }
+        }
+        offset = page.next_page_offset;
+    } while (offset);
+    return count;
+}
+//# sourceMappingURL=qdrant-query-utils.js.map

package/dist/utils/qdrant-query-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-query-utils.js","sourceRoot":"","sources":["../../src/utils/qdrant-query-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAAoB,EAAE,cAAsB,EAAE,UAAkB;IAC1G,MAAM,MAAM,GAAG,gBAAgB,CAAC,eAAe,EAAE,CAAC,eAAe,CAAC,CAAC;IACnE,IAAI,MAAM,GAAQ,SAAS,CAAC;IAC5B,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,GAAG,CAAC;QACF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAS,CAAC,CAAC;QACxI,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM;QACrD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC5B,IAAI,CAAC,EAAE,MAAM,IAAK,CAAC,CAAC,MAAc,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC/C,KAAK,IAAI,CAAC,CAAC;YACb,CAAC;QACH,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACjC,CAAC,QAAQ,MAAM,EAAE;IACjB,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/utils/qdrant-utils.d.ts

@@ -0,0 +1,5 @@
+export * from './qdrant-vector-types.js';
+export * from './qdrant-collection-utils.js';
+export * from './qdrant-vector-management.js';
+export * from './qdrant-query-utils.js';
+//# sourceMappingURL=qdrant-utils.d.ts.map

package/dist/utils/qdrant-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-utils.d.ts","sourceRoot":"","sources":["../../src/utils/qdrant-utils.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC"}

package/dist/utils/qdrant-utils.js

@@ -0,0 +1,5 @@
+export * from './qdrant-vector-types.js';
+export * from './qdrant-collection-utils.js';
+export * from './qdrant-vector-management.js';
+export * from './qdrant-query-utils.js';
+//# sourceMappingURL=qdrant-utils.js.map

package/dist/utils/qdrant-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-utils.js","sourceRoot":"","sources":["../../src/utils/qdrant-utils.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC"}

package/dist/utils/qdrant-vector-management.d.ts

@@ -0,0 +1,25 @@
+import { QdrantClient } from '@qdrant/js-client-rest';
+import { VectorDescriptorMap } from './qdrant-vector-types.js';
+/**
+ * Add named vectors to an existing collection by updating its config.
+ * This uses client.updateCollection and will fail if the server does not support the operation.
+ */
+export declare function addVectorsToCollection(client: QdrantClient, collectionName: string, vectors: VectorDescriptorMap): Promise<void>;
+/**
+ * Migrate points from one named vector to another by re-embedding content.
+ * Assumes the new vector space is already added to the collection.
+ * @param client Qdrant client
+ * @param collectionName Collection name
+ * @param fromVectorName Source vector name (e.g., 'vs1024')
+ * @param toVectorName Target vector name (e.g., 'vs1536')
+ * @param embeddingService Service to generate new embeddings
+ * @param batchSize Batch size for migration (default 64)
+ */
+export declare function migrateVectorSpace(client: QdrantClient, collectionName: string, fromVectorName: string, toVectorName: string, embeddingService: any, // EmbeddingService
+batchSize?: number): Promise<void>;
+/**
+ * Remove a named vector from the collection after migration.
+ * Note: Qdrant may not support removing vectors once added; this is a placeholder.
+ */
+export declare function removeVectorFromCollection(client: QdrantClient, collectionName: string, vectorName: string): Promise<void>;
+//# sourceMappingURL=qdrant-vector-management.d.ts.map

package/dist/utils/qdrant-vector-management.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-vector-management.d.ts","sourceRoot":"","sources":["../../src/utils/qdrant-vector-management.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAM/D;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqGtI;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,gBAAgB,EAAE,GAAG,EAAE,mBAAmB;AAC1C,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,IAAI,CAAC,CAqEf;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6FhI"}

package/dist/utils/qdrant-vector-management.js

@@ -0,0 +1,284 @@
+import { logger } from './logger.js';
+import { createQdrantCollection } from './qdrant-collection-utils.js';
+import { KAIROS_APP_SPACE_ID } from '../config.js';
+import { getSpaceContext } from '../utils/tenant-context.js';
+import { buildSpaceFilter } from '../utils/space-filter.js';
+/**
+ * Add named vectors to an existing collection by updating its config.
+ * This uses client.updateCollection and will fail if the server does not support the operation.
+ */
+export async function addVectorsToCollection(client, collectionName, vectors) {
+    logger.info(`addVectorsToCollection: Attempting to add vectors [${Object.keys(vectors).join(', ')}] to collection ${collectionName}`);
+    try {
+        const updateCtx = { vectors: {} };
+        Object.entries(vectors).forEach(([k, v]) => {
+            updateCtx.vectors[k] = { size: v.size, distance: v.distance || 'Cosine', on_disk: v.on_disk };
+        });
+        // Attempt to call Qdrant updateCollection if available
+        if (typeof client.updateCollection === 'function') {
+            await client.updateCollection(collectionName, { vectors: updateCtx.vectors });
+            logger.info(`addVectorsToCollection: updateCollection called successfully for ${collectionName} -> added ${Object.keys(updateCtx.vectors).join(',')}`);
+        }
+        else {
+            // Try fallback: for older JS client versions, may not support updateCollection
+            throw new Error('Qdrant client does not support updateCollection; please recreate collection with named vectors');
+        }
+    }
+    catch (err) {
+        // If updateCollection fails because server doesn't allow adding new vector names, we need a safer migration path
+        const msg = err?.data?.status?.error || err?.message || String(err);
+        logger.warn(`addVectorsToCollection: updateCollection failed: ${msg}`);
+        // Heuristic: detect "Not existing vector name" error and attempt safe recreate + restore
+        if (String(msg).includes('Not existing vector name') || String(msg).includes('Not existing named vector')) {
+            logger.info(`addVectorsToCollection: detected inability to add vector via updateCollection, starting recreation-based migration for ${collectionName} to add vectors [${Object.keys(vectors).join(', ')}]`);
+            // Step 1: Gather existing points via scroll in batches
+            const allPoints = [];
+            const filter = buildSpaceFilter(getSpaceContext().allowedSpaceIds);
+            let offset = undefined;
+            do {
+                const page = await client.scroll(collectionName, {
+                    filter,
+                    with_payload: true,
+                    with_vector: true,
+                    limit: 256,
+                    offset
+                });
+                if (!page?.points || page.points.length === 0)
+                    break;
+                for (const p of page.points) {
+                    allPoints.push({ id: p.id, payload: p.payload, vector: p.vector });
+                }
+                offset = page.next_page_offset;
+            } while (offset);
+            logger.info(`addVectorsToCollection: fetched ${allPoints.length} points from ${collectionName} for recreation`);
+            // Step 2: Recreate collection with merged vector set (existing vectors + requested)
+            // Gather existing vector descriptors so we can merge them
+            let mergedVectors = {};
+            try {
+                const existingCollectionInfo = await client.getCollection(collectionName);
+                const existingVectors = existingCollectionInfo.config?.params?.vectors;
+                if (existingVectors) {
+                    if (typeof existingVectors === 'object' && !existingVectors?.size) {
+                        Object.entries(existingVectors).forEach(([k, v]) => {
+                            mergedVectors[k] = { size: v.size, distance: v.distance || 'Cosine', on_disk: v.on_disk };
+                        });
+                    }
+                    else if (typeof existingVectors === 'object' && existingVectors.size) {
+                        // legacy single-vector
+                        const ev = existingVectors;
+                        mergedVectors[`vs${ev.size}`] = { size: ev.size, distance: ev.distance || 'Cosine', on_disk: ev.on_disk };
+                    }
+                }
+            }
+            catch (infoErr) {
+                // ignore; best-effort merge
+                logger.warn(`addVectorsToCollection: could not read existing collection info for ${collectionName}: ${String(infoErr)}`);
+            }
+            mergedVectors = { ...mergedVectors, ...vectors };
+            // We simply delete and recreate the collection with the desired vectors
+            try {
+                await client.deleteCollection(collectionName);
+                // small pause to ensure deletion is processed
+                await new Promise(resolve => setTimeout(resolve, 500));
+            }
+            catch (delErr) {
+                logger.warn(`addVectorsToCollection: failed to delete collection ${collectionName}: ${String(delErr)}; attempting to proceed`);
+            }
+            await createQdrantCollection(client, collectionName, mergedVectors);
+            logger.info(`addVectorsToCollection: recreated collection ${collectionName} with new vectors: ${Object.keys(mergedVectors).join(',')}`);
+            // Step 3: Re-insert points in batches to prevent memory pressure
+            const BATCH_SIZE = 256;
+            logger.info(`addVectorsToCollection: starting restore of ${allPoints.length} points to collection ${collectionName} (batchSize=${BATCH_SIZE})`);
+            let restored = 0;
+            for (let i = 0; i < allPoints.length; i += BATCH_SIZE) {
+                const batch = allPoints.slice(i, i + BATCH_SIZE).map(pt => ({
+                    id: pt.id,
+                    vector: pt.vector,
+                    payload: { ...pt.payload, space_id: pt.payload?.space_id ?? KAIROS_APP_SPACE_ID }
+                }));
+                try {
+                    await client.upsert(collectionName, { points: batch });
+                    restored += batch.length;
+                    logger.info(`addVectorsToCollection: upserted ${batch.length} restored points to ${collectionName} (restored total=${restored})`);
+                }
+                catch (upErr) {
+                    // If we fail here, try to continue and log
+                    logger.error(`addVectorsToCollection: failed upserting batch during recreation: ${String(upErr)}`);
+                }
+            }
+            logger.info(`addVectorsToCollection: restore complete, collection ${collectionName} now contains ${restored} points (attempted ${allPoints.length})`);
+            return;
+        }
+        throw err;
+    }
+}
+/**
+ * Migrate points from one named vector to another by re-embedding content.
+ * Assumes the new vector space is already added to the collection.
+ * @param client Qdrant client
+ * @param collectionName Collection name
+ * @param fromVectorName Source vector name (e.g., 'vs1024')
+ * @param toVectorName Target vector name (e.g., 'vs1536')
+ * @param embeddingService Service to generate new embeddings
+ * @param batchSize Batch size for migration (default 64)
+ */
+export async function migrateVectorSpace(client, collectionName, fromVectorName, toVectorName, embeddingService, // EmbeddingService
+batchSize = 64) {
+    let offset = undefined;
+    let migrated = 0;
+    let failed = 0;
+    logger.info(`migrateVectorSpace: Starting migration from ${fromVectorName} to ${toVectorName} in collection ${collectionName} - status=START`);
+    const filter = buildSpaceFilter(getSpaceContext().allowedSpaceIds);
+    do {
+        // Scroll points with the old vector
+        const page = await client.scroll(collectionName, {
+            filter,
+            with_payload: true,
+            with_vector: [fromVectorName], // Only fetch the old vector
+            limit: batchSize,
+            offset
+        });
+        if (!page.points || page.points.length === 0)
+            break;
+        const updates = [];
+        for (const point of page.points) {
+            const payload = point.payload;
+            // Re-embed the content to get new vector
+            const textToEmbed = [
+                payload.description_full || '',
+                payload.label || '',
+                payload.text || '',
+                `Tags: ${(payload.tags || []).join(', ')}`
+            ].filter(t => t.trim()).join('\n');
+            if (!textToEmbed.trim()) {
+                logger.warn(`Point ${point.id} has no embeddable content, skipping`);
+                continue;
+            }
+            let newVector = null;
+            try {
+                const embeddingResult = await embeddingService.generateEmbedding(textToEmbed);
+                newVector = embeddingResult.embedding;
+            }
+            catch (embedErr) {
+                failed += 1;
+                logger.warn(`migrateVectorSpace: failed to generate embedding for point ${point.id}; skipping; reason=${String(embedErr)}`);
+                continue;
+            }
+            // Prepare update: set new vector, keep payload
+            updates.push({
+                id: point.id,
+                vector: { [toVectorName]: newVector },
+                payload // Keep existing payload
+            });
+        }
+        if (updates.length > 0) {
+            try {
+                await client.upsert(collectionName, { points: updates });
+                migrated += updates.length;
+                logger.info(`migrateVectorSpace: Migrated ${updates.length} points in current batch, total migrated: ${migrated}`);
+            }
+            catch (upErr) {
+                // If upsert fails, log and attempt to continue
+                logger.error(`migrateVectorSpace: failed to upsert migrated vectors batch: ${String(upErr)}; migrated so far: ${migrated}`);
+            }
+        }
+        offset = page.next_page_offset;
+    } while (offset);
+    logger.info(`migrateVectorSpace: Migration complete for ${collectionName}: migrated=${migrated}, failed=${failed}, from=${fromVectorName}, to=${toVectorName} - status=COMPLETE`);
+}
+/**
+ * Remove a named vector from the collection after migration.
+ * Note: Qdrant may not support removing vectors once added; this is a placeholder.
+ */
+export async function removeVectorFromCollection(client, collectionName, vectorName) {
+    logger.info(`removeVectorFromCollection: Attempting to remove vector '${vectorName}' from collection '${collectionName}'`);
+    // Recreate the collection without the given vectorName by gathering all points, removing the vector field,
+    // and recreating the collection with a merged vector map that excludes the vectorName.
+    try {
+        const collectionInfo = await client.getCollection(collectionName);
+        const vectors = collectionInfo.config?.params?.vectors;
+        if (!vectors) {
+            logger.warn(`removeVectorFromCollection: No vector config found for ${collectionName}; nothing to remove`);
+            return;
+        }
+        // Convert to descriptor map
+        const existingVectors = {};
+        if (typeof vectors === 'object' && !vectors.size) {
+            Object.entries(vectors).forEach(([k, v]) => {
+                existingVectors[k] = { size: v.size, distance: v.distance || 'Cosine', on_disk: v.on_disk };
+            });
+        }
+        else if (typeof vectors === 'object' && vectors.size) {
+            // Single root vector; cannot remove unless recreating collection & leaving no vectors which is invalid
+            const ev = vectors;
+            existingVectors[`vs${ev.size}`] = { size: ev.size, distance: ev.distance || 'Cosine', on_disk: ev.on_disk };
+        }
+        if (!(vectorName in existingVectors)) {
+            logger.info(`removeVectorFromCollection: vector '${vectorName}' not present in collection '${collectionName}', nothing to remove`);
+            return;
+        }
+        // Build new vector map excluding the vectorName
+        const newVectors = {};
+        Object.entries(existingVectors).forEach(([k, v]) => {
+            if (k !== vectorName)
+                newVectors[k] = v;
+        });
+        if (Object.keys(newVectors).length === 0) {
+            logger.error(`removeVectorFromCollection: Cannot remove vector '${vectorName}' as it would leave collection '${collectionName}' without any vectors`);
+            return;
+        }
+        // Gather all points and strip the vectorName from all points
+        const filter = buildSpaceFilter(getSpaceContext().allowedSpaceIds);
+        const allPoints = [];
+        let offset = undefined;
+        do {
+            const page = await client.scroll(collectionName, { filter, with_payload: true, with_vector: true, limit: 256, offset });
+            if (!page?.points || page.points.length === 0)
+                break;
+            for (const p of page.points) {
+                const vec = p.vector || {};
+                // Copy all vector fields except the removed one
+                const newVectorFields = {};
+                Object.entries(vec).forEach(([vn, v]) => {
+                    if (vn !== vectorName)
+                        newVectorFields[vn] = v;
+                });
+                allPoints.push({ id: p.id, vector: newVectorFields, payload: p.payload });
+            }
+            offset = page.next_page_offset;
+        } while (offset);
+        logger.info(`removeVectorFromCollection: Fetched ${allPoints.length} points from ${collectionName} to recreate without ${vectorName}`);
+        // Delete, recreate with new vectors, and upsert points (without the removed vector)
+        try {
+            await client.deleteCollection(collectionName);
+            await new Promise(resolve => setTimeout(resolve, 500));
+        }
+        catch (delErr) {
+            logger.warn(`removeVectorFromCollection: failed to delete collection ${collectionName}: ${String(delErr)}; attempting to proceed`);
+        }
+        await createQdrantCollection(client, collectionName, newVectors);
+        logger.info(`removeVectorFromCollection: recreated collection ${collectionName} without vector ${vectorName}; new vectors: ${Object.keys(newVectors).join(',')}`);
+        const BATCH_SIZE = 256;
+        let restored = 0;
+        for (let i = 0; i < allPoints.length; i += BATCH_SIZE) {
+            const batch = allPoints.slice(i, i + BATCH_SIZE).map(p => ({
+                id: p.id,
+                vector: p.vector,
+                payload: { ...p.payload, space_id: p.payload?.space_id ?? KAIROS_APP_SPACE_ID }
+            }));
+            try {
+                await client.upsert(collectionName, { points: batch });
+                restored += batch.length;
+                logger.info(`removeVectorFromCollection: upserted ${batch.length} restored points into ${collectionName} (restored=${restored})`);
+            }
+            catch (upErr) {
+                logger.error(`removeVectorFromCollection: upsert failed during recreation: ${String(upErr)}`);
+            }
+        }
+        logger.info(`removeVectorFromCollection: Completed removal of ${vectorName} on ${collectionName} - restored points=${restored}`);
+    }
+    catch (err) {
+        logger.error(`removeVectorFromCollection: removal failed for ${vectorName} on ${collectionName}: ${String(err)}`);
+    }
+}
+//# sourceMappingURL=qdrant-vector-management.js.map

package/dist/utils/qdrant-vector-management.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-vector-management.js","sourceRoot":"","sources":["../../src/utils/qdrant-vector-management.ts"],"names":[],"mappings":"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"}

package/dist/utils/qdrant-vector-types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Get the vector size from environment variable EMBEDDING_DIMENSION
+ */
+export type VectorDescriptor = {
+    size: number;
+    distance?: 'Cosine' | 'Euclid' | 'Dot';
+    on_disk?: boolean;
+};
+export type VectorDescriptorMap = Record<string, VectorDescriptor>;
+/**
+ * Get the vector size for the default provider (OpenAI) from environment variable EMBEDDING_DIMENSION
+ * Backwards compatible helper for single-vector deployments.
+ */
+export declare function getVectorSize(): number;
+/**
+ * Build a named vector configuration object from environment variables.
+ * Uses "vs{DIMENSION}" naming to support migration between dimensions.
+ * Only one vector space active at a time, but supports migration from old to new.
+ */
+export declare function getVectorDescriptors(): VectorDescriptorMap;
+/**
+ * Resolve a potential 'current' alias for Qdrant collection names.
+ *
+ * Usage:
+ * - If callers pass the literal alias 'current' (or an env var resolves to it),
+ *   this function returns the real collection name derived from:
+ *     1) process.env['QDRANT_COLLECTION_CURRENT']
+ *     2) process.env['QDRANT_COLLECTION'] (fallback)
+ *     3) the provided collection string (final fallback)
+ *
+ * This allows code to use the stable alias 'current' while the actual
+ * target collection can be changed via environment without touching code.
+ */
+export declare function resolveCollectionAlias(collectionName: string): string;
+//# sourceMappingURL=qdrant-vector-types.d.ts.map

package/dist/utils/qdrant-vector-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-vector-types.d.ts","sourceRoot":"","sources":["../../src/utils/qdrant-vector-types.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAC3G,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAEnE;;;GAGG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,mBAAmB,CAK1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAOrE"}

package/dist/utils/qdrant-vector-types.js

@@ -0,0 +1,42 @@
+import { getEmbeddingDimension, QDRANT_COLLECTION_CURRENT, getQdrantCollection } from '../config.js';
+/**
+ * Get the vector size for the default provider (OpenAI) from environment variable EMBEDDING_DIMENSION
+ * Backwards compatible helper for single-vector deployments.
+ */
+export function getVectorSize() {
+    return getEmbeddingDimension();
+}
+/**
+ * Build a named vector configuration object from environment variables.
+ * Uses "vs{DIMENSION}" naming to support migration between dimensions.
+ * Only one vector space active at a time, but supports migration from old to new.
+ */
+export function getVectorDescriptors() {
+    const dim = getEmbeddingDimension(1536);
+    const map = {};
+    map[`vs${dim}`] = { size: dim, distance: 'Cosine', on_disk: true };
+    return map;
+}
+/**
+ * Resolve a potential 'current' alias for Qdrant collection names.
+ *
+ * Usage:
+ * - If callers pass the literal alias 'current' (or an env var resolves to it),
+ *   this function returns the real collection name derived from:
+ *     1) process.env['QDRANT_COLLECTION_CURRENT']
+ *     2) process.env['QDRANT_COLLECTION'] (fallback)
+ *     3) the provided collection string (final fallback)
+ *
+ * This allows code to use the stable alias 'current' while the actual
+ * target collection can be changed via environment without touching code.
+ */
+export function resolveCollectionAlias(collectionName) {
+    if (!collectionName)
+        return collectionName;
+    if (collectionName === 'current') {
+        // Priority: explicit current mapping, then legacy QDRANT_COLLECTION, then alias itself
+        return QDRANT_COLLECTION_CURRENT || getQdrantCollection();
+    }
+    return collectionName;
+}
+//# sourceMappingURL=qdrant-vector-types.js.map

package/dist/utils/qdrant-vector-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-vector-types.js","sourceRoot":"","sources":["../../src/utils/qdrant-vector-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAQrG;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,qBAAqB,EAAE,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,GAAG,GAAwB,EAAE,CAAC;IACpC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACnE,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,sBAAsB,CAAC,cAAsB;IAC3D,IAAI,CAAC,cAAc;QAAE,OAAO,cAAc,CAAC;IAC3C,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;QACjC,uFAAuF;QACvF,OAAO,yBAAyB,IAAI,mBAAmB,EAAE,CAAC;IAC5D,CAAC;IACD,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/dist/utils/space-display.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Human-readable names for space IDs. Frontend (tools, responses) uses names; backend uses ids.
+ */
+/** Display label for the app space (embedded mem docs). */
+export declare const KAIROS_APP_SPACE_DISPLAY_NAME = "Kairos app";
+/**
+ * Map a space_id to a human-readable name for tool outputs and agent-facing responses.
+ * user:realm:sub → "Personal"; group:realm:ref → "Group: ref"; space:kairos-app → "Kairos app".
+ */
+export declare function spaceIdToDisplayName(spaceId: string): string;
+//# sourceMappingURL=space-display.d.ts.map

package/dist/utils/space-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-display.d.ts","sourceRoot":"","sources":["../../src/utils/space-display.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,2DAA2D;AAC3D,eAAO,MAAM,6BAA6B,eAAe,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ5D"}

package/dist/utils/space-display.js

@@ -0,0 +1,25 @@
+/**
+ * Human-readable names for space IDs. Frontend (tools, responses) uses names; backend uses ids.
+ */
+import { KAIROS_APP_SPACE_ID } from '../config.js';
+/** Display label for the app space (embedded mem docs). */
+export const KAIROS_APP_SPACE_DISPLAY_NAME = 'Kairos app';
+/**
+ * Map a space_id to a human-readable name for tool outputs and agent-facing responses.
+ * user:realm:sub → "Personal"; group:realm:ref → "Group: ref"; space:kairos-app → "Kairos app".
+ */
+export function spaceIdToDisplayName(spaceId) {
+    if (!spaceId || typeof spaceId !== 'string')
+        return 'Unknown';
+    if (spaceId === KAIROS_APP_SPACE_ID)
+        return KAIROS_APP_SPACE_DISPLAY_NAME;
+    const parts = spaceId.split(':');
+    if (parts[0] === 'user')
+        return 'Personal';
+    if (parts[0] === 'group' && parts.length >= 3)
+        return `Group: ${parts[2]}`;
+    if (parts[0] === 'space' && parts.length >= 2)
+        return parts.slice(1).join(':') || spaceId;
+    return spaceId;
+}
+//# sourceMappingURL=space-display.js.map

package/dist/utils/space-display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"space-display.js","sourceRoot":"","sources":["../../src/utils/space-display.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,6BAA6B,GAAG,YAAY,CAAC;AAE1D;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC9D,IAAI,OAAO,KAAK,mBAAmB;QAAE,OAAO,6BAA6B,CAAC;IAC1E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM;QAAE,OAAO,UAAU,CAAC;IAC3C,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,UAAU,KAAK,CAAC,CAAC,CAAE,EAAE,CAAC;IAC5E,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC;IAC1F,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/space-filter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Build Qdrant filter for space isolation. Merges space_id constraint with optional existing filter.
+ */
+/** Qdrant filter shape (must array of conditions). */
+export interface QdrantFilterMust {
+    must?: Array<Record<string, unknown>>;
+}
+/**
+ * Build a filter that restricts results to points whose space_id is in allowedSpaceIds.
+ * Merges with existingFilter.must so callers can add domain, chain.id, etc.
+ */
+export declare function buildSpaceFilter(allowedSpaceIds: string[], existingFilter?: QdrantFilterMust): {
+    must: Array<Record<string, unknown>>;
+};
+//# sourceMappingURL=space-filter.d.ts.map