@squadrules/mcp 4.8.6

package/dist/services/qdrant/reward-propagation.js

@@ -0,0 +1,62 @@
+import { getSpaceContext } from '../../utils/tenant-context.js';
+import { buildSpaceFilter } from '../../utils/space-filter.js';
+import { updateQualityMetrics } from './quality.js';
+import { logger } from '../../utils/structured-logger.js';
+import { redisCacheService } from '../redis-cache.js';
+import { retrieveAccessiblePointById } from './memory-retrieval.js';
+/**
+ * Resolve the adapter head from a completion layer and propagate reward
+ * quality metrics so activation ranking can see the final outcome.
+ */
+export async function propagateRewardToAdapterHead(conn, stepPointId, metricsUpdate) {
+    return conn.executeWithReconnect(async () => {
+        const stepPoint = await retrieveAccessiblePointById(conn, stepPointId);
+        if (!stepPoint) {
+            logger.debug(`[reward-propagation] Step ${stepPointId} not found, skip propagation`);
+            return null;
+        }
+        const payload = stepPoint.payload;
+        if (!payload) {
+            logger.debug(`[reward-propagation] Step ${stepPointId} has no payload, skip propagation`);
+            return null;
+        }
+        const adapterId = payload['adapter']?.id;
+        if (!adapterId || typeof adapterId !== 'string') {
+            logger.debug(`[reward-propagation] Step ${stepPointId} has no adapter.id, skip propagation`);
+            return null;
+        }
+        const layerIndex = payload['adapter']?.layer_index;
+        if (layerIndex === 1) {
+            logger.debug(`[reward-propagation] Step ${stepPointId} is already the adapter head, skip propagation`);
+            return null;
+        }
+        const filter = buildSpaceFilter(getSpaceContext().allowedSpaceIds, {
+            must: [
+                { key: 'adapter.id', match: { value: adapterId } },
+                { key: 'adapter.layer_index', match: { value: 1 } }
+            ]
+        });
+        const scrollResult = await conn.client.scroll(conn.collectionName, {
+            filter,
+            limit: 1,
+            with_payload: false,
+            with_vector: false
+        });
+        const points = scrollResult?.points ?? [];
+        if (points.length === 0) {
+            logger.warn(`[reward-propagation] Adapter head not found for adapter ${adapterId}, skip propagation`);
+            return null;
+        }
+        const adapterHeadId = String(points[0].id);
+        await updateQualityMetrics(conn, adapterHeadId, metricsUpdate);
+        try {
+            await redisCacheService.invalidateBeginCache();
+        }
+        catch (cacheErr) {
+            logger.warn(`[reward-propagation] Cache invalidation failed after adapter head update (adapterHeadId=${adapterHeadId}); reward succeeded: ${cacheErr instanceof Error ? cacheErr.message : String(cacheErr)}`);
+        }
+        logger.info(`[reward-propagation] Updated adapter head ${adapterHeadId} for adapter ${adapterId}`);
+        return adapterHeadId;
+    });
+}
+//# sourceMappingURL=reward-propagation.js.map

package/dist/services/qdrant/reward-propagation.js.map

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

package/dist/services/qdrant/search.d.ts

@@ -0,0 +1,22 @@
+import { QdrantConnection } from './connection.js';
+/**
+ * searchMemory - vector similarity search wrapper
+ */
+export declare function searchMemory(conn: QdrantConnection, query: string, limit?: number, domain?: string): Promise<{
+    id: any;
+    description: any;
+    content: any;
+    confidence: any;
+    relevance: any;
+    domain: any;
+    task: any;
+    type: any;
+    tags: any;
+    created_at: any;
+    protocol: any;
+    uri: any;
+    memory_uuid: any;
+    step_number: any;
+    quality_metadata: any;
+}[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/services/qdrant/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/services/qdrant/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOnD;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;KAwExG"}

package/dist/services/qdrant/search.js

@@ -0,0 +1,76 @@
+import { embeddingService } from '../embedding/service.js';
+import { logger } from '../../utils/structured-logger.js';
+import { qdrantOperations, qdrantQueryDuration } from '../metrics/qdrant-metrics.js';
+import { getTenantId, getSpaceContext } from '../../utils/tenant-context.js';
+import { buildSpaceFilter } from '../../utils/space-filter.js';
+/**
+ * searchMemory - vector similarity search wrapper
+ */
+export async function searchMemory(conn, query, limit, domain) {
+    return conn.executeWithReconnect(async () => {
+        const tenantId = getTenantId();
+        const timer = qdrantQueryDuration.startTimer({ tenant_id: tenantId });
+        try {
+            const limitVal = limit || 10;
+            logger.debug(`searchMemory called query="${query.slice(0, 80)}..." domain=${domain || 'all'} limit=${limitVal}`);
+            const queryEmbeddingResult = await embeddingService.generateEmbedding(query);
+            const queryVector = queryEmbeddingResult.embedding;
+            logger.debug(`Query embedding generated, length=${queryVector.length}`);
+            const allowedSpaceIds = getSpaceContext().allowedSpaceIds;
+            const domainFilter = domain ? { must: [{ key: 'domain', match: { value: domain } }] } : undefined;
+            const filter = buildSpaceFilter(allowedSpaceIds, domainFilter);
+            const searchParams = {
+                query: queryVector,
+                using: `vs${queryVector.length}`,
+                limit: limitVal,
+                filter,
+                params: { quantization: { rescore: conn.rescoreEnabled } }
+            };
+            logger.debug(`[Qdrant][search] collection=${conn.collectionName} req=${JSON.stringify(searchParams)}`);
+            const searchResult = (await conn.client.query(conn.collectionName, searchParams))?.points ?? [];
+            logger.debug(`Qdrant search returned ${searchResult?.length || 0} results`);
+            qdrantOperations.inc({
+                operation: 'search',
+                status: 'success',
+                tenant_id: tenantId
+            });
+            timer({ tenant_id: tenantId });
+            if (searchResult && searchResult.length > 0) {
+                return searchResult.map((result) => {
+                    const payload = result.payload;
+                    return {
+                        id: result.id.toString(),
+                        description: payload.label || 'Memory',
+                        content: typeof payload.text === 'string' ? payload.text : '',
+                        confidence: result.score,
+                        relevance: result.score,
+                        domain: payload.domain || 'general',
+                        task: payload.task || 'search_result',
+                        type: payload.type || 'context',
+                        tags: Array.isArray(payload.tags) ? payload.tags : [],
+                        created_at: typeof payload.created_at === 'string' ? payload.created_at : new Date().toISOString(),
+                        protocol: payload.protocol,
+                        uri: payload.uri,
+                        memory_uuid: result.id.toString(),
+                        step_number: payload.protocol?.step,
+                        quality_metadata: payload.quality_metadata || {
+                            step_quality_score: 1,
+                            step_quality: 'standard'
+                        }
+                    };
+                });
+            }
+            return [];
+        }
+        catch (error) {
+            qdrantOperations.inc({
+                operation: 'search',
+                status: 'error',
+                tenant_id: tenantId
+            });
+            timer({ tenant_id: tenantId });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/services/qdrant/search.js.map

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

package/dist/services/qdrant/service.d.ts

@@ -0,0 +1,96 @@
+import * as retrieval from './memory-retrieval.js';
+import { UpsertResourceItem, UpsertResourceResult } from './types.js';
+export declare class QdrantService {
+    private conn;
+    constructor(qdrantUrl?: string, apiKey?: string, collectionName?: string, caCertPath?: string);
+    get client(): any;
+    get collectionName(): string;
+    get qdrantUrl(): string;
+    get apiKey(): string;
+    initialize(): Promise<void>;
+    storeMemory(label: string, text: string, domain: string, task: string, type?: string, tags?: string[], embedding?: number[], protocol?: {
+        step: number;
+        total: number;
+        enforcement: 'sequential' | 'flexible';
+        skip_allowed: boolean;
+        title?: string;
+        memory_uuid?: string;
+    }, uuid?: string): Promise<{
+        qdrantId: string;
+    }>;
+    upsertResources(items: UpsertResourceItem[]): Promise<UpsertResourceResult[]>;
+    retrieveById(uuid: string): Promise<{
+        uuid: string;
+        payload: any;
+    } | null>;
+    getMemoryByUUID(uuid: string): Promise<any>;
+    getAdapterLayers(adapterId: string, extraSpaceIds?: string[]): Promise<{
+        uuid: string;
+        payload: any;
+    }[]>;
+    /** Exact slug lookup: first layer UUID of the protocol adapter, or null. */
+    findFirstStepMemoryUuidBySlug(slug: string): Promise<retrieval.SlugResolveOutcome>;
+    findArtifactMemoryUuidBySlug(slug: string): Promise<retrieval.ArtifactSlugResolveOutcome>;
+    updateMemoryByUUID(uuid: string, updatesPayload: any): Promise<void>;
+    updateMemory(id: string, updatesPayload: any): Promise<void>;
+    deleteMemory(id: string): Promise<void>;
+    updateQualityMetrics(id: string, metrics: any): Promise<void>;
+    updateQualityMetadata(id: string, qualityMetadata: any): Promise<void>;
+    /** Propagate reward metrics from the completion layer to the adapter head. */
+    propagateRewardToAdapterHead(stepPointId: string, metricsUpdate: Record<string, unknown>): Promise<string | null>;
+    trackPendingValidation(id: string, modelId: string, protocolStep?: number): Promise<void>;
+    searchMemory(query: string, limit?: number, domain?: string): Promise<{
+        id: any;
+        description: any;
+        content: any;
+        confidence: any;
+        relevance: any;
+        domain: any;
+        task: any;
+        type: any;
+        tags: any;
+        created_at: any;
+        protocol: any;
+        uri: any;
+        memory_uuid: any;
+        step_number: any;
+        quality_metadata: any;
+    }[]>;
+    findProtocolSteps(protocolId: string): Promise<{
+        uuid: any;
+        protocol: any;
+        payload: any;
+    }[]>;
+    findProtocolStep(domain: string, type: string, task: string, step: number): Promise<{
+        uuid: string;
+        payload: Record<string, unknown> | {
+            [key: string]: unknown;
+        } | null | undefined;
+    } | null>;
+    createOrUpdateAlias(aliasName?: string): Promise<void>;
+    getCollections(): Promise<string[]>;
+    dropCollection(name: string): Promise<void>;
+    listItemsByCategory(domain: string, type: string, task: string): Promise<{
+        id: any;
+        label: any;
+        text: any;
+        domain: any;
+        task: any;
+        type: any;
+        tags: any;
+        protocol: any;
+        uri: any;
+        created_at: any;
+    }[]>;
+    getDomainOverview(domain: string): Promise<{
+        total_memories: number;
+        top_categories: string[];
+        recent_memories: {
+            id: string;
+            description: string;
+            created_at: string;
+        }[];
+    }>;
+}
+export declare const qdrantService: QdrantService;
+//# sourceMappingURL=service.d.ts.map

package/dist/services/qdrant/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/qdrant/service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,SAAS,MAAM,uBAAuB,CAAC;AAQnD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAItE,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAmB;gBAG7B,SAAS,GAAE,MAAuB,EAClC,MAAM,GAAE,MAAuB,EAC/B,cAAc,GAAE,MAA8B,EAC9C,UAAU,CAAC,EAAE,MAAM;IAQrB,IAAW,MAAM,IAAI,GAAG,CAEvB;IAED,IAAW,cAAc,IAAI,MAAM,CAElC;IAED,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,CACT,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,MAAM,EACb,IAAI,CAAC,EAAE,MAAM,EAAE,EACf,SAAS,CAAC,EAAE,MAAM,EAAE,EACpB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,YAAY,GAAG,UAAU,CAAC;QAAC,YAAY,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAC/I,IAAI,CAAC,EAAE,MAAM;;;IAKf,eAAe,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAI7E,YAAY,CAAC,IAAI,EAAE,MAAM;;;;IAIzB,eAAe,CAAC,IAAI,EAAE,MAAM;IAI5B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,EAAE;;;;IAI5D,4EAA4E;IAC5E,6BAA6B,CAAC,IAAI,EAAE,MAAM;IAI1C,4BAA4B,CAAC,IAAI,EAAE,MAAM;IAIzC,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG;IAIpD,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG;IAI5C,YAAY,CAAC,EAAE,EAAE,MAAM;IAIvB,oBAAoB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG;IAI7C,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,GAAG;IAItD,8EAA8E;IAC9E,4BAA4B,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIjH,sBAAsB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM;IAIzE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;IAI3D,iBAAiB,CAAC,UAAU,EAAE,MAAM;;;;;IAIpC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;;;IAIzE,mBAAmB,CAAC,SAAS,GAAE,MAAkB;IAIjD,cAAc;IAId,cAAc,CAAC,IAAI,EAAE,MAAM;IAI3B,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;;;;;;;;;IAI9D,iBAAiB,CAAC,MAAM,EAAE,MAAM;;;;;;;;;CAGjC;AAED,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/services/qdrant/service.js

@@ -0,0 +1,107 @@
+import { QdrantConnection } from './connection.js';
+import * as init from './initialization.js';
+import * as store from './memory-store.js';
+import * as retrieval from './memory-retrieval.js';
+import { updateMemory, updateMemoryByUUID, deleteMemory } from './memory-updates.js';
+import * as quality from './quality.js';
+import * as resources from './resources.js';
+import * as search from './search.js';
+import * as protocol from './protocol.js';
+import * as listing from './listing.js';
+import * as rewardPropagation from './reward-propagation.js';
+import { logger } from '../../utils/structured-logger.js';
+import { getQdrantUrl, QDRANT_API_KEY, getQdrantCollection } from '../../config.js';
+export class QdrantService {
+    conn;
+    constructor(qdrantUrl = getQdrantUrl(), apiKey = QDRANT_API_KEY, collectionName = getQdrantCollection(), caCertPath) {
+        this.conn = new QdrantConnection(qdrantUrl, apiKey, collectionName, caCertPath);
+        logger.info(`QdrantService composed for collection=${this.conn.collectionName}`);
+    }
+    /* Expose underlying connection properties via safe getters so other modules can use them without
+       accessing private internals directly. This avoids direct bracket-access of private fields. */
+    get client() {
+        return this.conn.client;
+    }
+    get collectionName() {
+        return this.conn.collectionName;
+    }
+    get qdrantUrl() {
+        return this.conn.qdrantUrl;
+    }
+    get apiKey() {
+        return this.conn.apiKey;
+    }
+    initialize() {
+        return init.initializeCollection(this.conn);
+    }
+    storeMemory(label, text, domain, task, type, tags, embedding, protocol, uuid) {
+        return store.storeMemory(this.conn, label, text, domain, task, type, tags, embedding, protocol, uuid);
+    }
+    upsertResources(items) {
+        return resources.upsertResources(this.conn, items);
+    }
+    retrieveById(uuid) {
+        return retrieval.retrieveById(this.conn, uuid);
+    }
+    getMemoryByUUID(uuid) {
+        return retrieval.getMemoryByUUID(this.conn, uuid);
+    }
+    getAdapterLayers(adapterId, extraSpaceIds) {
+        return retrieval.getAdapterLayers(this.conn, adapterId, extraSpaceIds);
+    }
+    /** Exact slug lookup: first layer UUID of the protocol adapter, or null. */
+    findFirstStepMemoryUuidBySlug(slug) {
+        return retrieval.findFirstStepMemoryUuidBySlug(this.conn, slug);
+    }
+    findArtifactMemoryUuidBySlug(slug) {
+        return retrieval.findArtifactMemoryUuidBySlug(this.conn, slug);
+    }
+    updateMemoryByUUID(uuid, updatesPayload) {
+        return updateMemoryByUUID(this.conn, uuid, updatesPayload);
+    }
+    updateMemory(id, updatesPayload) {
+        return updateMemory(this.conn, id, updatesPayload);
+    }
+    deleteMemory(id) {
+        return deleteMemory(this.conn, id);
+    }
+    updateQualityMetrics(id, metrics) {
+        return quality.updateQualityMetrics(this.conn, id, metrics);
+    }
+    updateQualityMetadata(id, qualityMetadata) {
+        return quality.updateQualityMetadata(this.conn, id, qualityMetadata);
+    }
+    /** Propagate reward metrics from the completion layer to the adapter head. */
+    propagateRewardToAdapterHead(stepPointId, metricsUpdate) {
+        return rewardPropagation.propagateRewardToAdapterHead(this.conn, stepPointId, metricsUpdate);
+    }
+    trackPendingValidation(id, modelId, protocolStep) {
+        return quality.trackPendingValidation(this.conn, id, modelId, protocolStep);
+    }
+    searchMemory(query, limit, domain) {
+        return search.searchMemory(this.conn, query, limit, domain);
+    }
+    findProtocolSteps(protocolId) {
+        return protocol.findProtocolSteps(this.conn, protocolId);
+    }
+    findProtocolStep(domain, type, task, step) {
+        return protocol.findProtocolStep(this.conn, domain, type, task, step);
+    }
+    createOrUpdateAlias(aliasName = 'current') {
+        return init.createOrUpdateAlias(this.conn, aliasName);
+    }
+    getCollections() {
+        return init.getCollections(this.conn);
+    }
+    dropCollection(name) {
+        return init.dropCollection(this.conn, name);
+    }
+    listItemsByCategory(domain, type, task) {
+        return listing.listItemsByCategory(this.conn, domain, type, task);
+    }
+    getDomainOverview(domain) {
+        return listing.getDomainOverview(this.conn, domain);
+    }
+}
+export const qdrantService = new QdrantService();
+//# sourceMappingURL=service.js.map

package/dist/services/qdrant/service.js.map

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

package/dist/services/qdrant/snapshots.d.ts

@@ -0,0 +1,19 @@
+import type { QdrantService } from './service.js';
+type SnapshotReason = 'startup' | 'api';
+export interface SnapshotOptions {
+    enabled: boolean;
+    directory: string;
+    reason: SnapshotReason;
+}
+export interface SnapshotResult {
+    success: boolean;
+    skipped?: boolean;
+    snapshotName?: string;
+    filePath?: string;
+    bytesWritten?: number;
+    durationMs?: number;
+    message?: string;
+}
+export declare function triggerQdrantSnapshot(qdrantService: QdrantService, options: SnapshotOptions): Promise<SnapshotResult>;
+export {};
+//# sourceMappingURL=snapshots.d.ts.map

package/dist/services/qdrant/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../../src/services/qdrant/snapshots.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,KAAK,cAAc,GAAG,SAAS,GAAG,KAAK,CAAC;AAExC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2CD,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAiGzB"}

package/dist/services/qdrant/snapshots.js

@@ -0,0 +1,130 @@
+import path from 'node:path';
+import { createWriteStream } from 'node:fs';
+import { mkdir, rm, stat } from 'node:fs/promises';
+import { pipeline } from 'node:stream/promises';
+import { Readable } from 'node:stream';
+import { structuredLogger } from '../../utils/structured-logger.js';
+function sanitizeTimestamp(date = new Date()) {
+    return date.toISOString().replace(/[:.]/g, '-');
+}
+async function ensureDirectory(targetDir) {
+    const resolved = path.isAbsolute(targetDir) ? targetDir : path.resolve(targetDir);
+    await mkdir(resolved, { recursive: true });
+    const stats = await stat(resolved);
+    if (!stats.isDirectory()) {
+        throw new Error(`Snapshot path is not a directory: ${resolved}`);
+    }
+    return resolved;
+}
+async function removePartialFile(filePath) {
+    if (!filePath)
+        return;
+    try {
+        await rm(filePath);
+    }
+    catch {
+        // Intentionally ignore cleanup errors.
+    }
+}
+function buildHeaders(apiKey) {
+    const headers = {
+        'content-type': 'application/json',
+    };
+    if (apiKey) {
+        headers['api-key'] = apiKey;
+    }
+    return headers;
+}
+function createSnapshotFilename(reason, collection) {
+    return `kairos-${reason}-${collection}-${sanitizeTimestamp()}.snapshot`;
+}
+function normalizeBaseUrl(url) {
+    return url.endsWith('/') ? url.slice(0, -1) : url;
+}
+export async function triggerQdrantSnapshot(qdrantService, options) {
+    if (!options.enabled) {
+        structuredLogger.info(`[snapshot:${options.reason}] Disabled via configuration`);
+        return { success: false, skipped: true, message: 'disabled' };
+    }
+    if (!options.directory || options.directory.trim() === '') {
+        structuredLogger.info(`[snapshot:${options.reason}] Backup directory not configured`);
+        return { success: false, skipped: true, message: 'Backup directory is not defined in server settings.' };
+    }
+    const start = Date.now();
+    const collection = qdrantService.collectionName;
+    const baseUrl = normalizeBaseUrl(qdrantService.qdrantUrl);
+    const headers = buildHeaders(qdrantService.apiKey);
+    const snapshotCreateUrl = `${baseUrl}/collections/${encodeURIComponent(collection)}/snapshots`;
+    let snapshotName;
+    let filePath;
+    try {
+        const resolvedDir = await ensureDirectory(options.directory);
+        const createResponse = await fetch(snapshotCreateUrl, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({ wait: true }),
+        });
+        if (!createResponse.ok) {
+            const body = await createResponse.text().catch(() => '');
+            structuredLogger.error(`[snapshot:${options.reason}] Qdrant snapshot create failed: HTTP ${createResponse.status} - ${body}`);
+            return {
+                success: false,
+                message: `Failed to create snapshot: HTTP ${createResponse.status}`,
+            };
+        }
+        const responseJson = await createResponse.json().catch(() => ({}));
+        snapshotName =
+            responseJson?.['result']?.['name'] ||
+                responseJson?.['snapshot']?.['name'] ||
+                responseJson?.['name'] ||
+                responseJson?.['result'];
+        if (!snapshotName || typeof snapshotName !== 'string') {
+            structuredLogger.error(`[snapshot:${options.reason}] Snapshot create response missing name: ${JSON.stringify(responseJson)}`);
+            return {
+                success: false,
+                message: 'Snapshot created but no name returned',
+            };
+        }
+        const downloadUrl = `${snapshotCreateUrl}/${encodeURIComponent(snapshotName)}`;
+        const downloadResponse = await fetch(downloadUrl, { method: 'GET', headers });
+        if (!downloadResponse.ok || !downloadResponse.body) {
+            const body = await downloadResponse.text().catch(() => '');
+            structuredLogger.error(`[snapshot:${options.reason}] Snapshot download failed: HTTP ${downloadResponse.status} - ${body}`);
+            return {
+                success: false,
+                snapshotName: snapshotName,
+                message: `Failed to download snapshot: HTTP ${downloadResponse.status}`,
+            };
+        }
+        filePath = path.join(resolvedDir, createSnapshotFilename(options.reason, collection));
+        const writeStream = createWriteStream(filePath);
+        let bytesWritten = 0;
+        const readable = Readable.fromWeb(downloadResponse.body);
+        readable.on('data', (chunk) => {
+            bytesWritten += chunk.length;
+        });
+        await pipeline(readable, writeStream);
+        const durationMs = Date.now() - start;
+        structuredLogger.info(`[snapshot:${options.reason}] Qdrant snapshot completed: ${snapshotName} -> ${filePath} (${bytesWritten} bytes, ${durationMs}ms)`);
+        return {
+            success: true,
+            snapshotName,
+            filePath,
+            bytesWritten,
+            durationMs,
+        };
+    }
+    catch (error) {
+        await removePartialFile(filePath);
+        structuredLogger.error(`[snapshot:${options.reason}] Snapshot pipeline failed: ${error instanceof Error ? error.message : String(error)}`);
+        const result = {
+            success: false,
+            message: error instanceof Error ? error.message : String(error),
+        };
+        if (snapshotName) {
+            result.snapshotName = snapshotName;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/services/qdrant/snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.js","sourceRoot":"","sources":["../../../src/services/qdrant/snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAqBpE,SAAS,iBAAiB,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE;IAC1C,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAClD,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,SAAiB;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClF,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,qCAAqC,QAAQ,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,QAA4B;IAC3D,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAAe;IACnC,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;KACnC,CAAC;IACF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAsB,EAAE,UAAkB;IACxE,OAAO,UAAU,MAAM,IAAI,UAAU,IAAI,iBAAiB,EAAE,WAAW,CAAC;AAC1E,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,aAA4B,EAC5B,OAAwB;IAExB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,gBAAgB,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,MAAM,8BAA8B,CAAC,CAAC;QACjF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;IAChE,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC1D,gBAAgB,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,MAAM,mCAAmC,CAAC,CAAC;QACtF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,qDAAqD,EAAE,CAAC;IAC3G,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,UAAU,GAAG,aAAa,CAAC,cAAc,CAAC;IAChD,MAAM,OAAO,GAAG,gBAAgB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAEnD,MAAM,iBAAiB,GAAG,GAAG,OAAO,gBAAgB,kBAAkB,CAAC,UAAU,CAAC,YAAY,CAAC;IAC/F,IAAI,YAAgC,CAAC;IACrC,IAAI,QAA4B,CAAC;IAEjC,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,cAAc,GAAG,MAAM,KAAK,CAAC,iBAAiB,EAAE;YACpD,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;SACrC,CAAC,CAAC;QAEH,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACzD,gBAAgB,CAAC,KAAK,CAAC,aAAa,OAAO,CAAC,MAAM,yCAAyC,cAAc,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;YAC9H,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,mCAAmC,cAAc,CAAC,MAAM,EAAE;aACpE,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAwB,CAAC;QAC1F,YAAY;YACV,YAAY,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC;gBAClC,YAAY,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC;gBACpC,YAAY,EAAE,CAAC,MAAM,CAAC;gBACtB,YAAY,EAAE,CAAC,QAAQ,CAAC,CAAC;QAE3B,IAAI,CAAC,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;YACtD,gBAAgB,CAAC,KAAK,CAAC,aAAa,OAAO,CAAC,MAAM,4CAA4C,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAC9H,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,uCAAuC;aACjD,CAAC;QACJ,CAAC;QAED,MAAM,WAAW,GAAG,GAAG,iBAAiB,IAAI,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC;QAC/E,MAAM,gBAAgB,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAE9E,IAAI,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;YACnD,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC3D,gBAAgB,CAAC,KAAK,CAAC,aAAa,OAAO,CAAC,MAAM,oCAAoC,gBAAgB,CAAC,MAAM,MAAM,IAAI,EAAE,CAAC,CAAC;YAC3H,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,YAAY,EAAE,YAAa;gBAC3B,OAAO,EAAE,qCAAqC,gBAAgB,CAAC,MAAM,EAAE;aACxE,CAAC;QACJ,CAAC;QAED,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,sBAAsB,CAAC,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;QACtF,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,YAAY,GAAG,CAAC,CAAC;QACrB,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAW,CAAC,CAAC;QAChE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5B,YAAY,IAAI,KAAK,CAAC,MAAM,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,MAAM,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAEtC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QACtC,gBAAgB,CAAC,IAAI,CAAC,aAAa,OAAO,CAAC,MAAM,gCAAgC,YAAY,OAAO,QAAQ,KAAK,YAAY,WAAW,UAAU,KAAK,CAAC,CAAC;QAEzJ,OAAO;YACL,OAAO,EAAE,IAAI;YACb,YAAY;YACZ,QAAQ;YACR,YAAY;YACZ,UAAU;SACX,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAClC,gBAAgB,CAAC,KAAK,CAAC,aAAa,OAAO,CAAC,MAAM,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC3I,MAAM,MAAM,GAAmB;YAC7B,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAChE,CAAC;QACF,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,CAAC,YAAY,GAAG,YAAY,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/services/qdrant/types.d.ts

@@ -0,0 +1,39 @@
+export interface UpsertResourceItem {
+    uuid?: string | undefined;
+    label: string;
+    text: string;
+    domain: string;
+    task: string;
+    type?: 'context' | 'rule' | 'snippet' | 'pattern';
+    tags?: string[];
+    protocol?: {
+        step: number;
+        total: number;
+        enforcement: 'sequential' | 'flexible';
+        skip_allowed: boolean;
+        title?: string;
+        memory_uuid?: string;
+    };
+    ai: {
+        model_id: string;
+        memory_uuid?: string;
+    };
+    quality_metadata?: {
+        step_quality_score: number;
+        step_quality: 'excellent' | 'high' | 'standard' | 'basic';
+    };
+}
+export interface UpsertResourceResult {
+    uri: string;
+    uuid: string;
+    status: 'created' | 'updated';
+    version: number;
+    protocol_id?: string | undefined;
+    protocol_uuid?: string | undefined;
+    memory_uuid?: string | undefined;
+    quality_metadata?: {
+        step_quality_score: number;
+        step_quality: 'excellent' | 'high' | 'standard' | 'basic';
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/qdrant/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/qdrant/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAClD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,YAAY,GAAG,UAAU,CAAC;QACvC,YAAY,EAAE,OAAO,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,EAAE,EAAE;QACF,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,gBAAgB,CAAC,EAAE;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,YAAY,EAAE,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;KAC3D,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,gBAAgB,CAAC,EAAE;QACjB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,YAAY,EAAE,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;KAC3D,CAAC;CACH"}

package/dist/services/qdrant/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/qdrant/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/qdrant/types.ts"],"names":[],"mappings":""}

package/dist/services/qdrant/undici-compat.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Qdrant client currently injects `dispatcher` into fetch init.
+ * On Node 25+, that dispatcher from qdrant's undici v6 is not compatible
+ * with the runtime fetch internals and causes `InvalidArgumentError: invalid onError method`.
+ * Strip only that field and preserve all other init options.
+ */
+export declare function installQdrantFetchCompatibility(): void;
+//# sourceMappingURL=undici-compat.d.ts.map

package/dist/services/qdrant/undici-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undici-compat.d.ts","sourceRoot":"","sources":["../../../src/services/qdrant/undici-compat.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CActD"}