@squadrules/mcp 4.8.6

package/dist/services/qdrant/listing.js

@@ -0,0 +1,88 @@
+import { logger } from '../../utils/structured-logger.js';
+import { getSpaceContext } from '../../utils/tenant-context.js';
+import { buildSpaceFilter } from '../../utils/space-filter.js';
+/**
+ * Listing helpers: listItemsByCategory, getDomainOverview
+ */
+export async function listItemsByCategory(conn, domain, type, task) {
+    return conn.executeWithReconnect(async () => {
+        const filter = buildSpaceFilter(getSpaceContext().allowedSpaceIds, {
+            must: [
+                { key: 'domain', match: { value: domain } },
+                { key: 'type', match: { value: type } },
+                { key: 'task', match: { value: task } }
+            ]
+        });
+        const result = await conn.client.scroll(conn.collectionName, {
+            filter,
+            limit: 100,
+            with_payload: true,
+            with_vector: false
+        });
+        if (!result.points)
+            return [];
+        return result.points.map((point) => {
+            const payload = point.payload;
+            return {
+                id: point.id.toString(),
+                label: payload.label || 'No description',
+                text: payload.text || '',
+                domain: payload.domain,
+                task: payload.task,
+                type: payload.type,
+                tags: payload.tags || [],
+                protocol: payload.protocol,
+                uri: payload.uri,
+                created_at: payload.created_at || new Date().toISOString()
+            };
+        });
+    });
+}
+export async function getDomainOverview(conn, domain) {
+    return conn.executeWithReconnect(async () => {
+        try {
+            const filter = buildSpaceFilter(getSpaceContext().allowedSpaceIds, { must: [{ key: 'domain', match: { value: domain } }] });
+            const countResult = await conn.client.scroll(conn.collectionName, {
+                filter,
+                limit: 100,
+                with_payload: true,
+                with_vector: false
+            });
+            const points = countResult.points || [];
+            const totalMemories = points.length;
+            const tagCounts = new Map();
+            const recentMemoriesData = [];
+            for (const point of points) {
+                const payload = point.payload;
+                if (payload.tags && Array.isArray(payload.tags)) {
+                    for (const tag of payload.tags)
+                        tagCounts.set(tag, (tagCounts.get(tag) || 0) + 1);
+                }
+                recentMemoriesData.push({
+                    id: point.id.toString(),
+                    description: payload.label || 'No description',
+                    created_at: payload.created_at || new Date().toISOString(),
+                    timestamp: new Date(payload.created_at || Date.now()).getTime()
+                });
+            }
+            const topCategories = Array.from(tagCounts.entries())
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 5)
+                .map(([tag]) => tag);
+            const recentMemories = recentMemoriesData
+                .sort((a, b) => b.timestamp - a.timestamp)
+                .slice(0, 5)
+                .map(({ id, description, created_at }) => ({ id, description, created_at }));
+            return {
+                total_memories: totalMemories,
+                top_categories: topCategories.length > 0 ? topCategories : ['No categories found'],
+                recent_memories: recentMemories.length > 0 ? recentMemories : []
+            };
+        }
+        catch (error) {
+            logger.warn(`getDomainOverview error for domain ${domain}: ${error instanceof Error ? error.message : String(error)}`);
+            return { total_memories: 0, top_categories: [], recent_memories: [] };
+        }
+    });
+}
+//# sourceMappingURL=listing.js.map

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

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

package/dist/services/qdrant/memory-retrieval.d.ts

@@ -0,0 +1,54 @@
+import { QdrantConnection } from './connection.js';
+/**
+ * Retrieval helpers
+ */
+export interface AccessiblePoint {
+    id: string;
+    payload: any;
+    vector?: any;
+}
+export type PointAccessResult = {
+    status: 'not_found';
+} | {
+    status: 'forbidden';
+    pointId: string;
+    spaceId: string;
+} | {
+    status: 'allowed';
+    point: AccessiblePoint;
+};
+export declare function retrievePointAccessById(conn: QdrantConnection, uuid: string, options?: {
+    withVector?: boolean;
+}): Promise<PointAccessResult>;
+export declare function retrieveAccessiblePointById(conn: QdrantConnection, uuid: string, options?: {
+    withVector?: boolean;
+}): Promise<AccessiblePoint | null>;
+export declare function retrieveById(conn: QdrantConnection, uuid: string): Promise<{
+    uuid: string;
+    payload: any;
+} | null>;
+export declare function getMemoryByUUID(conn: QdrantConnection, uuid: string): Promise<any | null>;
+export declare function getAdapterLayers(conn: QdrantConnection, adapterId: string, allowedSpaceIdsOverride?: string[]): Promise<Array<{
+    uuid: string;
+    payload: any;
+}>>;
+/** Result of resolving an adapter slug to an entry-layer point id. */
+export interface SlugResolveOutcome {
+    layerUuid: string | null;
+    /** Present when multiple adapters shared the slug; client should prefer explicit adapter URIs. */
+    disambiguation_note?: string;
+}
+export interface ArtifactSlugResolveOutcome {
+    artifactUuid: string | null;
+    disambiguation_note?: string;
+}
+/**
+ * Find the first adapter layer UUID for a protocol slug (exact match), scoped to searchable spaces.
+ * Paginates scroll so matches are not truncated at a small limit.
+ * If the slug maps to more than one adapter, picks deterministically by fixed precedence:
+ * personal > group > app/system, then lowest point id; logs and returns a disambiguation_note
+ * instead of failing the request.
+ */
+export declare function findFirstStepMemoryUuidBySlug(conn: QdrantConnection, slug: string): Promise<SlugResolveOutcome>;
+export declare function findArtifactMemoryUuidBySlug(conn: QdrantConnection, slug: string): Promise<ArtifactSlugResolveOutcome>;
+//# sourceMappingURL=memory-retrieval.d.ts.map

package/dist/services/qdrant/memory-retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-retrieval.d.ts","sourceRoot":"","sources":["../../../src/services/qdrant/memory-retrieval.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AASnD;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,GAAG,CAAC;IACb,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAElD,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAgC5B;AAED,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GACjC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAGjC;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,GAAG,IAAI,CAAC,CA8BvH;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CA8C/F;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,uBAAuB,CAAC,EAAE,MAAM,EAAE,GACjC,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,GAAG,CAAA;CAAE,CAAC,CAAC,CA4ChD;AAED,sEAAsE;AACtE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kGAAkG;IAClG,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,0BAA0B;IACzC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AASD;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,kBAAkB,CAAC,CAsE7B;AAED,wBAAsB,4BAA4B,CAChD,IAAI,EAAE,gBAAgB,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,0BAA0B,CAAC,CAiCrC"}

package/dist/services/qdrant/memory-retrieval.js

@@ -0,0 +1,278 @@
+import { validateAndConvertId } from './utils.js';
+import { qdrantOperations, qdrantOperationDuration } from '../metrics/qdrant-metrics.js';
+import { getTenantId, getSpaceContext, getSearchSpaceIds } from '../../utils/tenant-context.js';
+import { buildAdapterSiblingScrollFilter, buildSpaceFilter } from '../../utils/space-filter.js';
+import { KAIROS_APP_SPACE_ID } from '../../config.js';
+import { structuredLogger } from '../../utils/structured-logger.js';
+import { ALLOWED_ARTIFACT_MIMES } from '../../tools/artifact-mime.js';
+export async function retrievePointAccessById(conn, uuid, options) {
+    const validatedId = validateAndConvertId(uuid);
+    const withVector = options?.withVector ?? false;
+    const points = await conn.client.retrieve(conn.collectionName, {
+        ids: [validatedId],
+        with_payload: true,
+        with_vector: withVector
+    });
+    if (!points || points.length === 0) {
+        return { status: 'not_found' };
+    }
+    const point = points[0];
+    if (!point) {
+        return { status: 'not_found' };
+    }
+    const pointSpaceId = String(point.payload?.space_id ?? KAIROS_APP_SPACE_ID);
+    const allowed = getSpaceContext().allowedSpaceIds;
+    const canRead = allowed.includes(pointSpaceId) || pointSpaceId === KAIROS_APP_SPACE_ID;
+    if (!canRead) {
+        return { status: 'forbidden', pointId: String(point.id), spaceId: pointSpaceId };
+    }
+    return {
+        status: 'allowed',
+        point: {
+            id: String(point.id),
+            payload: point.payload,
+            ...(withVector ? { vector: point.vector } : {})
+        }
+    };
+}
+export async function retrieveAccessiblePointById(conn, uuid, options) {
+    const result = await retrievePointAccessById(conn, uuid, options);
+    return result.status === 'allowed' ? result.point : null;
+}
+export async function retrieveById(conn, uuid) {
+    return conn.executeWithReconnect(async () => {
+        const tenantId = getTenantId();
+        const timer = qdrantOperationDuration.startTimer({ operation: 'retrieve', tenant_id: tenantId });
+        try {
+            const point = await retrieveAccessiblePointById(conn, uuid);
+            if (!point) {
+                timer({ operation: 'retrieve', tenant_id: tenantId });
+                return null;
+            }
+            qdrantOperations.inc({
+                operation: 'retrieve',
+                status: 'success',
+                tenant_id: tenantId
+            });
+            timer({ operation: 'retrieve', tenant_id: tenantId });
+            return { uuid: point.id, payload: point.payload };
+        }
+        catch (error) {
+            qdrantOperations.inc({
+                operation: 'retrieve',
+                status: 'error',
+                tenant_id: tenantId
+            });
+            timer({ operation: 'retrieve', tenant_id: tenantId });
+            throw error;
+        }
+    });
+}
+export async function getMemoryByUUID(conn, uuid) {
+    return conn.executeWithReconnect(async () => {
+        const result = await retrieveById(conn, uuid);
+        if (!result)
+            return null;
+        const payload = result.payload;
+        return {
+            id: result.uuid,
+            label: payload.label || '',
+            text: payload.text || '',
+            domain: payload.domain || '',
+            task: payload.task || '',
+            type: payload.type || 'context',
+            tags: payload.tags || [],
+            protocol: payload.protocol,
+            quality_metrics: payload.quality_metrics,
+            quality_metadata: payload.quality_metadata,
+            memory_uuid: uuid,
+            adapter: payload.adapter ? {
+                id: payload.adapter.id,
+                name: payload.adapter.name,
+                layer_index: payload.adapter.layer_index,
+                layer_count: payload.adapter.layer_count,
+                ...(typeof payload.adapter.protocol_version === 'string' && {
+                    protocol_version: payload.adapter.protocol_version
+                }),
+                ...(Array.isArray(payload.adapter.activation_patterns) && {
+                    activation_patterns: payload.adapter.activation_patterns
+                }),
+                ...(typeof payload.adapter.reward_signal === 'string' && {
+                    reward_signal: payload.adapter.reward_signal
+                }),
+                ...(typeof payload.adapter.chain_root === 'string' && payload.adapter.chain_root.length > 0 && {
+                    chain_root: payload.adapter.chain_root
+                })
+            } : undefined,
+            inference_contract: payload.inference_contract,
+            embedding: [],
+            access_count: payload.quality_metrics?.retrievalCount || 0,
+            last_accessed: new Date(payload.updated_at || payload.created_at || Date.now()),
+            relevance_score: 1.0,
+            created_at: new Date(payload.created_at || Date.now()),
+            peak_contexts: [],
+            certainty: 0.8,
+            entropy: 0.2
+        };
+    });
+}
+export async function getAdapterLayers(conn, adapterId, allowedSpaceIdsOverride) {
+    return conn.executeWithReconnect(async () => {
+        const results = [];
+        let offset = undefined;
+        const spaceIds = allowedSpaceIdsOverride && allowedSpaceIdsOverride.length > 0
+            ? allowedSpaceIdsOverride
+            : getSearchSpaceIds();
+        const sibling = buildAdapterSiblingScrollFilter(spaceIds, adapterId);
+        const filter = {
+            must: sibling.must,
+            must_not: [
+                {
+                    key: 'content_type',
+                    match: {
+                        any: [...ALLOWED_ARTIFACT_MIMES]
+                    }
+                }
+            ]
+        };
+        do {
+            const page = await conn.client.scroll(conn.collectionName, {
+                filter,
+                with_payload: true,
+                with_vector: false,
+                limit: 256,
+                offset
+            });
+            (page.points || []).forEach((pt) => results.push({ uuid: String(pt.id), payload: pt.payload }));
+            offset = page.next_page_offset;
+        } while (offset);
+        results.sort((a, b) => {
+            const ai = typeof a.payload?.adapter?.layer_index === 'number'
+                ? a.payload.adapter.layer_index
+                : 0;
+            const bi = typeof b.payload?.adapter?.layer_index === 'number'
+                ? b.payload.adapter.layer_index
+                : 0;
+            return ai - bi;
+        });
+        return results;
+    });
+}
+function getSlugSpacePrecedence(spaceId) {
+    if (spaceId.startsWith('user:'))
+        return 0;
+    if (spaceId.startsWith('group:'))
+        return 1;
+    if (spaceId === KAIROS_APP_SPACE_ID || spaceId.startsWith('app:'))
+        return 2;
+    return 2;
+}
+/**
+ * Find the first adapter layer UUID for a protocol slug (exact match), scoped to searchable spaces.
+ * Paginates scroll so matches are not truncated at a small limit.
+ * If the slug maps to more than one adapter, picks deterministically by fixed precedence:
+ * personal > group > app/system, then lowest point id; logs and returns a disambiguation_note
+ * instead of failing the request.
+ */
+export async function findFirstStepMemoryUuidBySlug(conn, slug) {
+    return conn.executeWithReconnect(async () => {
+        const normalized = (slug || '').trim().toLowerCase();
+        if (!normalized)
+            return { layerUuid: null };
+        const filter = buildSpaceFilter(getSearchSpaceIds(), {
+            must: [
+                { key: 'slug', match: { value: normalized } },
+                { key: 'adapter.layer_index', match: { value: 1 } }
+            ]
+        });
+        const allPts = [];
+        let offset = undefined;
+        do {
+            const page = await conn.client.scroll(conn.collectionName, {
+                filter,
+                limit: 64,
+                offset,
+                with_payload: true,
+                with_vector: false
+            });
+            const pts = page.points || [];
+            allPts.push(...pts);
+            offset = page.next_page_offset;
+        } while (offset);
+        if (allPts.length === 0)
+            return { layerUuid: null };
+        allPts.sort((a, b) => String(a.id).localeCompare(String(b.id)));
+        const byAdapterId = new Map();
+        for (const p of allPts) {
+            const adapterId = typeof p.payload?.adapter?.id === 'string'
+                ? p.payload.adapter.id
+                : `__orphan_${String(p.id)}`;
+            if (!byAdapterId.has(adapterId))
+                byAdapterId.set(adapterId, p);
+        }
+        const unique = [...byAdapterId.values()];
+        if (unique.length === 1) {
+            return { layerUuid: String(unique[0].id) };
+        }
+        const spaceOf = (p) => String(p.payload?.space_id ?? KAIROS_APP_SPACE_ID);
+        const sorted = [...unique].sort((a, b) => {
+            const aPriority = getSlugSpacePrecedence(spaceOf(a));
+            const bPriority = getSlugSpacePrecedence(spaceOf(b));
+            if (aPriority !== bPriority)
+                return aPriority - bPriority;
+            return String(a.id).localeCompare(String(b.id));
+        });
+        const winner = sorted[0];
+        const chosenId = String(winner.id);
+        const adapterHint = typeof winner.payload?.adapter?.id === 'string'
+            ? winner.payload.adapter.id
+            : chosenId;
+        const winnerSpaceId = spaceOf(winner);
+        const contenderSummary = sorted
+            .map((point) => {
+            const pointId = String(point.id);
+            const adapterId = typeof point.payload?.adapter?.id === 'string' ? point.payload.adapter.id : pointId;
+            const pointSpaceId = spaceOf(point);
+            return `${adapterId}@${pointSpaceId}`;
+        })
+            .join(', ');
+        const note = `Slug "${normalized}" matched ${unique.length} adapters; selected "${adapterHint}" from "${winnerSpaceId}" by precedence (personal > group > app/system, then stable id). Candidates: ${contenderSummary}. Prefer an explicit adapter URI such as kairos://adapter/${adapterHint} to avoid ambiguity.`;
+        structuredLogger.warn(`[slug-resolve] ${note}`);
+        return { layerUuid: chosenId, disambiguation_note: note };
+    });
+}
+export async function findArtifactMemoryUuidBySlug(conn, slug) {
+    return conn.executeWithReconnect(async () => {
+        const normalized = (slug || '').trim().toLowerCase();
+        if (!normalized)
+            return { artifactUuid: null };
+        const filter = buildSpaceFilter(getSearchSpaceIds(), {
+            must: [{ key: 'artifact.slug', match: { value: normalized } }]
+        });
+        const allPts = [];
+        let offset = undefined;
+        do {
+            const page = await conn.client.scroll(conn.collectionName, {
+                filter,
+                limit: 64,
+                offset,
+                with_payload: true,
+                with_vector: false
+            });
+            const pts = page.points || [];
+            allPts.push(...pts);
+            offset = page.next_page_offset;
+        } while (offset);
+        if (allPts.length === 0)
+            return { artifactUuid: null };
+        if (allPts.length > 1) {
+            const candidates = allPts.map((point) => String(point.id)).join(', ');
+            return {
+                artifactUuid: null,
+                disambiguation_note: `Artifact slug "${normalized}" is ambiguous. Matching artifact UUIDs: ${candidates}`
+            };
+        }
+        return { artifactUuid: String(allPts[0].id) };
+    });
+}
+//# sourceMappingURL=memory-retrieval.js.map

package/dist/services/qdrant/memory-retrieval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-retrieval.js","sourceRoot":"","sources":["../../../src/services/qdrant/memory-retrieval.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAChG,OAAO,EAAE,+BAA+B,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAiBtE,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,IAAsB,EACtB,IAAY,EACZ,OAAkC;IAElC,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,KAAK,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE;QAC7D,GAAG,EAAE,CAAC,WAAW,CAAC;QAClB,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,UAAU;KACxB,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACxB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,MAAM,YAAY,GAAG,MAAM,CAAE,KAAK,CAAC,OAAe,EAAE,QAAQ,IAAI,mBAAmB,CAAC,CAAC;IACrF,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC,eAAe,CAAC;IAClD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,KAAK,mBAAmB,CAAC;IACvF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IACnF,CAAC;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE;YACL,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChD;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,IAAsB,EACtB,IAAY,EACZ,OAAkC;IAElC,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAClE,OAAO,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAsB,EAAE,IAAY;IACrE,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,IAAI,EAAE;QAC1C,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,uBAAuB,CAAC,UAAU,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEjG,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,2BAA2B,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC5D,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,KAAK,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACtD,OAAO,IAAI,CAAC;YACd,CAAC;YAED,gBAAgB,CAAC,GAAG,CAAC;gBACnB,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,SAAS;gBACjB,SAAS,EAAE,QAAQ;aACpB,CAAC,CAAC;YAEH,KAAK,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtD,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,gBAAgB,CAAC,GAAG,CAAC;gBACnB,SAAS,EAAE,UAAU;gBACrB,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,QAAQ;aACpB,CAAC,CAAC;YACH,KAAK,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;YACtD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAsB,EAAE,IAAY;IACxE,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,IAAI,EAAE;QAC1C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC/B,OAAO;YACL,EAAE,EAAE,MAAM,CAAC,IAAI;YACf,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACxB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;YAC5B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACxB,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,SAAS;YAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,EAAE;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;YAC1C,WAAW,EAAE,IAAI;YACjB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;gBACzB,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;gBACtB,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI;gBAC1B,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;gBACxC,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,WAAW;gBACxC,GAAG,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,gBAAgB,KAAK,QAAQ,IAAI;oBAC1D,gBAAgB,EAAE,OAAO,CAAC,OAAO,CAAC,gBAAgB;iBACnD,CAAC;gBACF,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI;oBACxD,mBAAmB,EAAE,OAAO,CAAC,OAAO,CAAC,mBAAmB;iBACzD,CAAC;gBACF,GAAG,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,KAAK,QAAQ,IAAI;oBACvD,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,aAAa;iBAC7C,CAAC;gBACF,GAAG,CAAC,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI;oBAC7F,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,UAAU;iBACvC,CAAC;aACH,CAAC,CAAC,CAAC,SAAS;YACb,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;YAC9C,SAAS,EAAE,EAAE;YACb,YAAY,EAAE,OAAO,CAAC,eAAe,EAAE,cAAc,IAAI,CAAC;YAC1D,aAAa,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAC/E,eAAe,EAAE,GAAG;YACpB,UAAU,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACtD,aAAa,EAAE,EAAE;YACjB,SAAS,EAAE,GAAG;YACd,OAAO,EAAE,GAAG;SACb,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,IAAsB,EACtB,SAAiB,EACjB,uBAAkC;IAElC,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,IAAI,EAAE;QAC1C,MAAM,OAAO,GAA0C,EAAE,CAAC;QAC1D,IAAI,MAAM,GAAQ,SAAS,CAAC;QAC5B,MAAM,QAAQ,GACZ,uBAAuB,IAAI,uBAAuB,CAAC,MAAM,GAAG,CAAC;YAC3D,CAAC,CAAC,uBAAuB;YACzB,CAAC,CAAC,iBAAiB,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,+BAA+B,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QACrE,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE;gBACR;oBACE,GAAG,EAAE,cAAc;oBACnB,KAAK,EAAE;wBACL,GAAG,EAAE,CAAC,GAAG,sBAAsB,CAAC;qBACjC;iBACF;aACF;SACF,CAAC;QACF,GAAG,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;gBACzD,MAAM;gBACN,YAAY,EAAE,IAAI;gBAClB,WAAW,EAAE,KAAK;gBAClB,KAAK,EAAE,GAAG;gBACV,MAAM;aACA,CAAC,CAAC;YACV,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,EAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACrG,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACjC,CAAC,QAAQ,MAAM,EAAE;QAEjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACpB,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,QAAQ;gBAC5D,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW;gBAC/B,CAAC,CAAC,CAAC,CAAC;YACN,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,KAAK,QAAQ;gBAC5D,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW;gBAC/B,CAAC,CAAC,CAAC,CAAC;YACN,OAAO,EAAE,GAAG,EAAE,CAAC;QACjB,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC;AAcD,SAAS,sBAAsB,CAAC,OAAe;IAC7C,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,OAAO,KAAK,mBAAmB,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,CAAC,CAAC;IAC5E,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,IAAsB,EACtB,IAAY;IAEZ,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,IAAI,EAAE;QAC1C,MAAM,UAAU,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrD,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,iBAAiB,EAAE,EAAE;YACnD,IAAI,EAAE;gBACJ,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;gBAC7C,EAAE,GAAG,EAAE,qBAAqB,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;aACpD;SACF,CAAC,CAAC;QAEH,MAAM,MAAM,GAAU,EAAE,CAAC;QACzB,IAAI,MAAM,GAAQ,SAAS,CAAC;QAC5B,GAAG,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;gBACzD,MAAM;gBACN,KAAK,EAAE,EAAE;gBACT,MAAM;gBACN,YAAY,EAAE,IAAI;gBAClB,WAAW,EAAE,KAAK;aACZ,CAAC,CAAC;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YACpB,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACjC,CAAC,QAAQ,MAAM,EAAE;QAEjB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QAEpD,MAAM,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAE1E,MAAM,WAAW,GAAG,IAAI,GAAG,EAAe,CAAC;QAC3C,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;YACvB,MAAM,SAAS,GACb,OAAO,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,QAAQ;gBACxC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;gBACtB,CAAC,CAAC,YAAY,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAC9C,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,CAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,QAAQ,IAAI,mBAAmB,CAAC,CAAC;QAC/E,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE;YACjD,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YACrD,MAAM,SAAS,GAAG,sBAAsB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YACrD,IAAI,SAAS,KAAK,SAAS;gBAAE,OAAO,SAAS,GAAG,SAAS,CAAC;YAC1D,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnC,MAAM,WAAW,GACf,OAAO,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,QAAQ;YAC7C,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;YAC3B,CAAC,CAAC,QAAQ,CAAC;QACf,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;QACtC,MAAM,gBAAgB,GAAG,MAAM;aAC5B,GAAG,CAAC,CAAC,KAAU,EAAE,EAAE;YAClB,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjC,MAAM,SAAS,GAAG,OAAO,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;YACtG,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;YACpC,OAAO,GAAG,SAAS,IAAI,YAAY,EAAE,CAAC;QACxC,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,IAAI,GAAG,SAAS,UAAU,aAAa,MAAM,CAAC,MAAM,wBAAwB,WAAW,WAAW,aAAa,gFAAgF,gBAAgB,6DAA6D,WAAW,sBAAsB,CAAC;QACpT,gBAAgB,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,IAAsB,EACtB,IAAY;IAEZ,OAAO,IAAI,CAAC,oBAAoB,CAAC,KAAK,IAAI,EAAE;QAC1C,MAAM,UAAU,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrD,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,gBAAgB,CAAC,iBAAiB,EAAE,EAAE;YACnD,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,CAAC;SAC/D,CAAC,CAAC;QAEH,MAAM,MAAM,GAAU,EAAE,CAAC;QACzB,IAAI,MAAM,GAAQ,SAAS,CAAC;QAC5B,GAAG,CAAC;YACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE;gBACzD,MAAM;gBACN,KAAK,EAAE,EAAE;gBACT,MAAM;gBACN,YAAY,EAAE,IAAI;gBAClB,WAAW,EAAE,KAAK;aACZ,CAAC,CAAC;YACV,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;YACpB,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACjC,CAAC,QAAQ,MAAM,EAAE;QAEjB,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QACvD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtE,OAAO;gBACL,YAAY,EAAE,IAAI;gBAClB,mBAAmB,EAAE,kBAAkB,UAAU,4CAA4C,UAAU,EAAE;aAC1G,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/services/qdrant/memory-store.d.ts

@@ -0,0 +1,16 @@
+import { QdrantConnection } from './connection.js';
+/**
+ * storeMemory - stores a single memory point in Qdrant
+ * @param uuid - Optional UUID to use as qdrantId. If provided, URI generation is skipped and this UUID is used directly.
+ */
+export declare function storeMemory(conn: QdrantConnection, 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;
+}>;
+//# sourceMappingURL=memory-store.d.ts.map

package/dist/services/qdrant/memory-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../../src/services/qdrant/memory-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AASnD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAkB,EACxB,IAAI,GAAE,MAAM,EAAO,EACnB,SAAS,GAAE,MAAM,EAAO,EACxB,QAAQ,CAAC,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,YAAY,GAAG,UAAU,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/I,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAqG/B"}

package/dist/services/qdrant/memory-store.js

@@ -0,0 +1,108 @@
+import { buildDomainTypeTaskURI, buildProtocolStepURI } from '../../utils/uri-builder.js';
+import { IDGenerator } from '../id-generator.js';
+import { sanitizeAndUpsert } from './utils.js';
+import { logger } from '../../utils/structured-logger.js';
+import { redisCacheService } from '../redis-cache.js';
+import { qdrantOperations, qdrantUpsertDuration } from '../metrics/qdrant-metrics.js';
+import { getTenantId, getSpaceContext } from '../../utils/tenant-context.js';
+/**
+ * storeMemory - stores a single memory point in Qdrant
+ * @param uuid - Optional UUID to use as qdrantId. If provided, URI generation is skipped and this UUID is used directly.
+ */
+export async function storeMemory(conn, label, text, domain, task, type = 'context', tags = [], embedding = [], protocol, uuid) {
+    return conn.executeWithReconnect(async () => {
+        const tenantId = getTenantId();
+        const timer = qdrantUpsertDuration.startTimer({ tenant_id: tenantId });
+        try {
+            let qdrantId;
+            let humanUri;
+            if (uuid) {
+                // Use provided UUID directly
+                qdrantId = uuid;
+                logger.debug(`storeMemory: Using provided UUID as qdrantId: ${qdrantId}`);
+            }
+            else {
+                // Generate URI and Qdrant ID as before
+                if (protocol && protocol.step) {
+                    humanUri = buildProtocolStepURI(domain, type, task, protocol.step);
+                    logger.debug(`storeMemory: Built protocol URI for step ${protocol.step}: ${humanUri}`);
+                }
+                else {
+                    humanUri = buildDomainTypeTaskURI(domain, type, task);
+                    logger.debug(`storeMemory: Built non-protocol URI: ${humanUri}`);
+                }
+                qdrantId = IDGenerator.buildQdrantId(humanUri);
+                logger.debug(`storeMemory: Generated Qdrant ID from URI: ${qdrantId} (from ${humanUri})`);
+            }
+            let aiWithContext = { model_id: 'unknown' };
+            if (protocol) {
+                aiWithContext = { model_id: 'unknown', memory_uuid: qdrantId };
+            }
+            const spaceId = getSpaceContext().defaultWriteSpaceId;
+            const point = {
+                id: qdrantId,
+                vector: { [`vs${embedding.length}`]: embedding },
+                payload: {
+                    space_id: spaceId,
+                    label,
+                    text,
+                    domain,
+                    task,
+                    type,
+                    tags,
+                    ai: aiWithContext,
+                    protocol: protocol,
+                    quality_metrics: {
+                        retrievalCount: 0,
+                        successCount: 0,
+                        partialCount: 0,
+                        failureCount: 0,
+                        lastRated: null,
+                        lastRater: null,
+                        qualityBonus: 0,
+                        usageContext: null,
+                        implementation_stats: {
+                            total_attempts: 0,
+                            success_attempts: 0,
+                            model_success_rates: {},
+                            confidence_level: 0,
+                            last_implementation_attempt: null
+                        },
+                        healer_contributions: {
+                            total_healers: 0,
+                            total_improvements: 0,
+                            healer_bonus_distributed: 0,
+                            last_healed: null,
+                            healer_models: {}
+                        },
+                        step_success_rates: {}
+                    },
+                    created_at: new Date().toISOString()
+                }
+            };
+            logger.debug(`storeMemory: About to upsert point with qdrantId: ${qdrantId}, humanUri: ${humanUri}`);
+            const upsertResult = await sanitizeAndUpsert(conn.client, conn.collectionName, [point]);
+            logger.debug(`storeMemory: Upsert result for qdrantId ${qdrantId}: ${JSON.stringify(upsertResult)}`);
+            // Invalidate memory, search, and activate caches after creation (publishes invalidation events internally)
+            await redisCacheService.invalidateMemoryCache(qdrantId);
+            await redisCacheService.invalidateAfterUpdate();
+            qdrantOperations.inc({
+                operation: 'upsert',
+                status: 'success',
+                tenant_id: tenantId
+            });
+            timer({ tenant_id: tenantId });
+            return { qdrantId };
+        }
+        catch (error) {
+            qdrantOperations.inc({
+                operation: 'upsert',
+                status: 'error',
+                tenant_id: tenantId
+            });
+            timer({ tenant_id: tenantId });
+            throw error;
+        }
+    });
+}
+//# sourceMappingURL=memory-store.js.map

package/dist/services/qdrant/memory-store.js.map

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

package/dist/services/qdrant/memory-updates.d.ts

@@ -0,0 +1,8 @@
+import { QdrantConnection } from './connection.js';
+/**
+ * Update memory by UUID (for protocol reconstruction) and general update/delete
+ */
+export declare function updateMemoryByUUID(conn: QdrantConnection, uuid: string, updates: any): Promise<void>;
+export declare function updateMemory(conn: QdrantConnection, id: string, updates: any): Promise<void>;
+export declare function deleteMemory(conn: QdrantConnection, id: string): Promise<void>;
+//# sourceMappingURL=memory-updates.d.ts.map

package/dist/services/qdrant/memory-updates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-updates.d.ts","sourceRoot":"","sources":["../../../src/services/qdrant/memory-updates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAUnD;;GAEG;AAEH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAiF1G;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAmGlG;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCpF"}