@squadrules/mcp 4.8.6

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

@@ -0,0 +1,241 @@
+import { logger } from '../../utils/structured-logger.js';
+import { KAIROS_APP_SPACE_ID } from '../../config.js';
+import { getSpaceContext, getSearchSpaceIds } from '../../utils/tenant-context.js';
+import { buildSpaceFilter } from '../../utils/space-filter.js';
+import { redisCacheService } from '../redis-cache.js';
+import { embeddingService } from '../embedding/service.js';
+import { bm25Tokenizer } from '../embedding/bm25-tokenizer.js';
+import { buildHeaderMemoryAdapter as buildAdapter } from './adapter-builder.js';
+import { KAIROS_CREATION_PROTOCOL_SLUG, KAIROS_REFINING_PROTOCOL_SLUG, memoryIsBuiltinSearchFooterProtocol } from '../../constants/builtin-search-meta.js';
+import { pointToMemory as mapQdrantPointToMemory } from './qdrant-point-to-memory.js';
+import { searchAdapterTitlesBySimilarity as searchAdapterTitlesBySimilarityImpl } from './store-title-similarity-search.js';
+import { getActivationPatternVectorName, getAdapterTitleVectorName, getPrimaryVectorName } from '../../utils/qdrant-vector-types.js';
+export class MemoryQdrantStoreMethods {
+    client;
+    collection;
+    url;
+    codeBlockProcessor;
+    constructor(client, collection, url, codeBlockProcessor) {
+        this.client = client;
+        this.collection = collection;
+        this.url = url;
+        this.codeBlockProcessor = codeBlockProcessor;
+    }
+    async getMemory(memory_uuid) {
+        if (!memory_uuid)
+            return null;
+        // Check shared cache first (Redis when configured, in-memory otherwise)
+        const cached = await redisCacheService.getMemoryResource(memory_uuid);
+        if (cached)
+            return cached;
+        const retrieveReq = {
+            ids: [memory_uuid],
+            with_payload: true,
+            with_vector: false
+        };
+        logger.debug(`[Qdrant][retrieve] collection=${this.collection} req=${JSON.stringify(retrieveReq)}`);
+        const points = await this.client.retrieve(this.collection, {
+            ids: [memory_uuid],
+            with_payload: true,
+            with_vector: false
+        });
+        logger.debug(`[Qdrant][retrieve] result_count=${points?.length || 0}`);
+        if (!points || points.length === 0) {
+            return null;
+        }
+        const point = points[0];
+        const pointSpaceId = 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 null;
+        }
+        const memory = this.pointToMemory(point);
+        // Populate shared cache for subsequent reads
+        await redisCacheService.setMemoryResource(memory);
+        return memory;
+    }
+    // Fetch bypassing in-process cache to ensure freshest view (e.g., after updates)
+    async getMemoryFresh(memory_uuid) {
+        if (!memory_uuid)
+            return null;
+        const points = await this.client.retrieve(this.collection, {
+            ids: [memory_uuid],
+            with_payload: true,
+            with_vector: false
+        });
+        if (!points || points.length === 0)
+            return null;
+        const point = points[0];
+        const pointSpaceId = 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 null;
+        }
+        return this.pointToMemory(point);
+    }
+    async searchMemories(query, limit, collapse = true) {
+        const queryKey = (query || '').trim();
+        if (!queryKey) {
+            return { memories: [], scores: [] };
+        }
+        const vectorResult = await this.vectorSearch(queryKey, limit);
+        await redisCacheService.setSearchResult(queryKey, limit, vectorResult, { collapse });
+        return vectorResult;
+    }
+    async searchAdapterTitlesBySimilarity(query, limit) {
+        return searchAdapterTitlesBySimilarityImpl({
+            client: this.client,
+            collection: this.collection,
+            query,
+            limit,
+            mapPointToMemory: (point) => this.pointToMemory(point)
+        });
+    }
+    /**
+     * Hybrid search: dense + activation-focused dense legs + BM25 via Query API.
+     * All ranking stays in Qdrant so the tool surface sees the same scores the
+     * index produced.
+     */
+    async vectorSearch(query, limit) {
+        const queryEmbeddingResult = await embeddingService.generateEmbedding(query);
+        const queryVector = queryEmbeddingResult.embedding;
+        const primaryVectorName = getPrimaryVectorName(queryVector.length);
+        const titleVectorName = getAdapterTitleVectorName(queryVector.length);
+        const activationPatternVectorName = getActivationPatternVectorName(queryVector.length);
+        const searchLimit = Math.min(limit * 3, 200);
+        const sparseQuery = bm25Tokenizer.tokenize(query);
+        const searchSpaceIds = getSearchSpaceIds();
+        const baseFilter = buildSpaceFilter(searchSpaceIds, {
+            must: [{ key: 'adapter.layer_index', match: { value: 1 } }]
+        });
+        const filter = {
+            ...baseFilter,
+            must_not: [{ key: 'slug', match: { any: [KAIROS_REFINING_PROTOCOL_SLUG, KAIROS_CREATION_PROTOCOL_SLUG] } }]
+        };
+        const bm25Leg = {
+            query: { indices: sparseQuery.indices, values: sparseQuery.values },
+            using: 'bm25',
+            filter
+        };
+        let points;
+        try {
+            const TITLE_MATCH_BOOST = 0.45;
+            const ACTIVATION_PATTERN_MATCH_BOOST = 0.35;
+            const LABEL_MATCH_BOOST = 0.15;
+            const TAG_MATCH_BOOST = 0.05;
+            const queryResponse = await this.client.query(this.collection, {
+                prefetch: {
+                    prefetch: [
+                        {
+                            query: queryVector,
+                            using: primaryVectorName,
+                            limit: 60,
+                            filter,
+                            params: { quantization: { rescore: true } }
+                        },
+                        {
+                            query: queryVector,
+                            using: titleVectorName,
+                            limit: 40,
+                            filter,
+                            params: { quantization: { rescore: true } }
+                        },
+                        {
+                            query: queryVector,
+                            using: activationPatternVectorName,
+                            limit: 40,
+                            filter,
+                            params: { quantization: { rescore: true } }
+                        },
+                        { ...bm25Leg, limit: 60 },
+                        { ...bm25Leg, limit: 30 }
+                    ],
+                    query: { fusion: 'rrf' },
+                    limit: 80,
+                },
+                query: {
+                    formula: {
+                        sum: [
+                            '$score',
+                            {
+                                mult: [
+                                    TITLE_MATCH_BOOST,
+                                    { key: 'adapter_name_text', match: { text: query } }
+                                ]
+                            },
+                            {
+                                mult: [
+                                    ACTIVATION_PATTERN_MATCH_BOOST,
+                                    { key: 'activation_patterns_text', match: { text: query } }
+                                ]
+                            },
+                            {
+                                mult: [
+                                    LABEL_MATCH_BOOST,
+                                    { key: 'label_text', match: { text: query } }
+                                ]
+                            },
+                            {
+                                mult: [
+                                    TAG_MATCH_BOOST,
+                                    { key: 'tags_text', match: { text: query } }
+                                ]
+                            },
+                            'attest_boost'
+                        ]
+                    },
+                    defaults: { attest_boost: 0 }
+                },
+                with_payload: true,
+                limit: searchLimit
+            });
+            points = queryResponse?.points ?? [];
+        }
+        catch (queryErr) {
+            logger.warn(`Hybrid query failed, falling back to dense search: ${queryErr instanceof Error ? queryErr.message : String(queryErr)}`);
+            const fallbackResponse = await this.client.query(this.collection, {
+                query: queryVector,
+                using: primaryVectorName,
+                limit: searchLimit,
+                filter,
+                params: { quantization: { rescore: true } },
+                with_payload: true,
+                with_vector: false
+            });
+            points = fallbackResponse?.points ?? [];
+        }
+        const scored = points.map((r) => {
+            const payload = r.payload || {};
+            const memory = this.pointToMemory({ id: String(r.id), payload });
+            const score = typeof r.score === 'number' ? r.score : 0.5;
+            return { memory, score };
+        });
+        let filtered = scored
+            .filter(entry => entry.score > 0 && !memoryIsBuiltinSearchFooterProtocol(entry.memory))
+            .sort((a, b) => {
+            if (b.score !== a.score)
+                return b.score - a.score;
+            return (a.memory.memory_uuid ?? '').localeCompare(b.memory.memory_uuid ?? '');
+        })
+            .slice(0, limit);
+        if (filtered.length === 0 && scored.length > 0) {
+            filtered = scored
+                .filter(entry => !memoryIsBuiltinSearchFooterProtocol(entry.memory))
+                .slice(0, limit)
+                .map(entry => ({ memory: entry.memory, score: 0.5 }));
+        }
+        return {
+            memories: filtered.map(entry => entry.memory),
+            scores: filtered.map(entry => entry.score)
+        };
+    }
+    pointToMemory(point) {
+        return mapQdrantPointToMemory(point);
+    }
+    buildHeaderMemoryAdapter(markdownDoc, llmModelId, now) {
+        return buildAdapter(markdownDoc, llmModelId, now, this.codeBlockProcessor);
+    }
+}
+//# sourceMappingURL=store-methods.js.map

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

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

package/dist/services/memory/store-title-similarity-search.d.ts

@@ -0,0 +1,16 @@
+import type { QdrantClient } from '@qdrant/js-client-rest';
+import type { Memory } from '../../types/memory.js';
+export declare function searchAdapterTitlesBySimilarity(params: {
+    client: QdrantClient;
+    collection: string;
+    query: string;
+    limit: number;
+    mapPointToMemory: (point: {
+        id: string;
+        payload: Record<string, unknown>;
+    }) => Memory;
+}): Promise<{
+    memories: Memory[];
+    scores: number[];
+}>;
+//# sourceMappingURL=store-title-similarity-search.d.ts.map

package/dist/services/memory/store-title-similarity-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store-title-similarity-search.d.ts","sourceRoot":"","sources":["../../../src/services/memory/store-title-similarity-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAOpD,wBAAsB,+BAA+B,CAAC,MAAM,EAAE;IAC5D,MAAM,EAAE,YAAY,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,CAAC,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,MAAM,CAAC;CACvF,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA8CpD"}

package/dist/services/memory/store-title-similarity-search.js

@@ -0,0 +1,50 @@
+import { embeddingService } from '../embedding/service.js';
+import { KAIROS_CREATION_PROTOCOL_SLUG, KAIROS_REFINING_PROTOCOL_SLUG, memoryIsBuiltinSearchFooterProtocol } from '../../constants/builtin-search-meta.js';
+import { buildSpaceFilter } from '../../utils/space-filter.js';
+import { getSearchSpaceIds } from '../../utils/tenant-context.js';
+import { getAdapterTitleVectorName } from '../../utils/qdrant-vector-types.js';
+export async function searchAdapterTitlesBySimilarity(params) {
+    const queryKey = (params.query || '').trim();
+    if (!queryKey) {
+        return { memories: [], scores: [] };
+    }
+    const queryEmbeddingResult = await embeddingService.generateEmbedding(queryKey);
+    const queryVector = queryEmbeddingResult.embedding;
+    const titleVectorName = getAdapterTitleVectorName(queryVector.length);
+    const searchSpaceIds = getSearchSpaceIds();
+    const baseFilter = buildSpaceFilter(searchSpaceIds, {
+        must: [{ key: 'adapter.layer_index', match: { value: 1 } }]
+    });
+    const filter = {
+        ...baseFilter,
+        must_not: [{ key: 'slug', match: { any: [KAIROS_REFINING_PROTOCOL_SLUG, KAIROS_CREATION_PROTOCOL_SLUG] } }]
+    };
+    const queryResponse = await params.client.query(params.collection, {
+        query: queryVector,
+        using: titleVectorName,
+        limit: params.limit,
+        filter,
+        params: { quantization: { rescore: true } },
+        with_payload: true,
+        with_vector: false
+    });
+    const points = queryResponse?.points ?? [];
+    const filtered = points
+        .map((point) => {
+        const memory = params.mapPointToMemory({ id: String(point.id), payload: point.payload || {} });
+        const score = typeof point.score === 'number' ? point.score : 0;
+        return { memory, score };
+    })
+        .filter(entry => entry.score > 0 && !memoryIsBuiltinSearchFooterProtocol(entry.memory))
+        .sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        return (a.memory.memory_uuid ?? '').localeCompare(b.memory.memory_uuid ?? '');
+    })
+        .slice(0, params.limit);
+    return {
+        memories: filtered.map(entry => entry.memory),
+        scores: filtered.map(entry => entry.score)
+    };
+}
+//# sourceMappingURL=store-title-similarity-search.js.map

package/dist/services/memory/store-title-similarity-search.js.map

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

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

@@ -0,0 +1,40 @@
+import { QdrantClient } from '@qdrant/js-client-rest';
+import type { Memory } from '../../types/memory.js';
+import type { StoreArtifactOptions } from './store-adapter.js';
+export interface MemoryQdrantStoreOptions {
+    url?: string;
+    collection?: string;
+}
+export declare class MemoryQdrantStore {
+    private client;
+    private collection;
+    private originalCollectionAlias?;
+    private url;
+    private codeBlockProcessor;
+    private methods;
+    private adapterStore;
+    constructor(options?: MemoryQdrantStoreOptions);
+    init(): Promise<void>;
+    checkHealth(timeoutMs?: number): Promise<boolean>;
+    storeAdapter(docs: string[], llmModelId: string, options?: {
+        forceUpdate?: boolean;
+        protocolVersion?: string;
+        forkNewAdapter?: boolean;
+    }): Promise<Memory[]>;
+    storeArtifact(content: string, options: StoreArtifactOptions): Promise<Memory[]>;
+    getMemory(memory_uuid: string, options?: {
+        fresh?: boolean;
+    }): Promise<Memory | null>;
+    searchMemories(query: string, limit: number, collapse?: boolean): Promise<{
+        memories: Memory[];
+        scores: number[];
+    }>;
+    /**
+     * Get Qdrant client and collection for direct access (used by boot injection)
+     */
+    getQdrantAccess(): {
+        client: QdrantClient;
+        collection: string;
+    };
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/services/memory/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAQpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAK/D,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,uBAAuB,CAAC,CAAS;IACzC,OAAO,CAAC,GAAG,CAAS;IACpB,OAAO,CAAC,kBAAkB,CAAqB;IAC/C,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,YAAY,CAA2B;gBAEnC,OAAO,GAAE,wBAA6B;IA0B5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,WAAW,CAAC,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAgEvD,YAAY,CAChB,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAO,GAC1F,OAAO,CAAC,MAAM,EAAE,CAAC;IAId,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIhF,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAOrF,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAc,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAI/H;;OAEG;IACH,eAAe,IAAI;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;CAGhE"}

package/dist/services/memory/store.js

@@ -0,0 +1,122 @@
+import { QdrantClient } from '@qdrant/js-client-rest';
+import { logger } from '../../utils/structured-logger.js';
+import { CodeBlockProcessor } from '../code-block-processor.js';
+import { MemoryQdrantStoreMethods } from './store-methods.js';
+import { resolveCollectionAlias } from '../../utils/qdrant-utils.js';
+import { getQdrantUrl, getQdrantCollection, QDRANT_API_KEY } from '../../config.js';
+import { initializeQdrantStore } from './store-init.js';
+import { MemoryQdrantStoreAdapter } from './store-adapter.js';
+const DEFAULT_QDRANT_URL = getQdrantUrl();
+const DEFAULT_COLLECTION = getQdrantCollection('kairos');
+export class MemoryQdrantStore {
+    client;
+    collection;
+    originalCollectionAlias;
+    url;
+    codeBlockProcessor;
+    methods;
+    adapterStore;
+    constructor(options = {}) {
+        const url = options.url || DEFAULT_QDRANT_URL;
+        const apiKey = QDRANT_API_KEY;
+        logger.info(`[MemoryQdrantStore] Initializing Qdrant client with QDRANT_URL="${url}", ` +
+            `collection="${options.collection || DEFAULT_COLLECTION}", apiKeyConfigured=${!!apiKey}`);
+        const clientOptions = { url };
+        if (apiKey) {
+            clientOptions['apiKey'] = apiKey;
+        }
+        this.client = new QdrantClient(clientOptions);
+        // Preserve original alias requested so we can log / manage it later
+        this.originalCollectionAlias = options.collection || DEFAULT_COLLECTION;
+        // Resolve 'current' alias to real collection name (env-driven) so callers may pass 'current'
+        this.collection = resolveCollectionAlias(options.collection || DEFAULT_COLLECTION);
+        logger.info(`[MemoryQdrantStore] Resolved collection alias: requested="${this.originalCollectionAlias}" resolved="${this.collection}"`);
+        this.url = url;
+        this.codeBlockProcessor = new CodeBlockProcessor();
+        this.methods = new MemoryQdrantStoreMethods(this.client, this.collection, this.url, this.codeBlockProcessor);
+        this.adapterStore = new MemoryQdrantStoreAdapter(this.client, this.collection, this.codeBlockProcessor, this.methods);
+    }
+    async init() {
+        return initializeQdrantStore(this.client, this.collection, this.url);
+    }
+    async checkHealth(timeoutMs = 5000) {
+        let timeoutId;
+        let raceCompleted = false;
+        let healthCheckPromise;
+        try {
+            // Wrap health check to handle cancellation cleanly
+            healthCheckPromise = (async () => {
+                try {
+                    const result = await this.client.getCollections();
+                    if (!raceCompleted && timeoutId) {
+                        clearTimeout(timeoutId);
+                    }
+                    return result;
+                }
+                catch (error) {
+                    if (!raceCompleted && timeoutId) {
+                        clearTimeout(timeoutId);
+                    }
+                    // Only throw if race hasn't completed (we won)
+                    if (!raceCompleted) {
+                        throw error;
+                    }
+                    // Otherwise ignore - timeout already won, return undefined
+                    return undefined;
+                }
+            })();
+            const timeoutPromise = new Promise((_, reject) => {
+                timeoutId = setTimeout(() => {
+                    if (!raceCompleted) {
+                        raceCompleted = true;
+                        reject(new Error(`Health check timed out after ${timeoutMs}ms`));
+                    }
+                }, timeoutMs);
+            });
+            await Promise.race([healthCheckPromise, timeoutPromise]);
+            raceCompleted = true;
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+            return true;
+        }
+        catch (error) {
+            raceCompleted = true;
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+            // Suppress any unhandled rejections from the losing promise
+            // by ensuring healthCheckPromise is handled
+            if (healthCheckPromise) {
+                healthCheckPromise.catch(() => {
+                    // Ignore - race already completed
+                });
+            }
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            logger.warn(`[MemoryQdrantStore] Qdrant health check failed at "${this.url}" (collection="${this.collection}"): ${errorMessage}`);
+            return false;
+        }
+    }
+    async storeAdapter(docs, llmModelId, options = {}) {
+        return this.adapterStore.storeAdapter(docs, llmModelId, options);
+    }
+    async storeArtifact(content, options) {
+        return this.adapterStore.storeArtifact(content, options);
+    }
+    async getMemory(memory_uuid, options) {
+        if (options?.fresh) {
+            return this.methods.getMemoryFresh(memory_uuid);
+        }
+        return this.methods.getMemory(memory_uuid);
+    }
+    async searchMemories(query, limit, collapse = true) {
+        return this.methods.searchMemories(query, limit, collapse);
+    }
+    /**
+     * Get Qdrant client and collection for direct access (used by boot injection)
+     */
+    getQdrantAccess() {
+        return { client: this.client, collection: this.collection };
+    }
+}
+//# sourceMappingURL=store.js.map

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

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

package/dist/services/memory/validate-adapter-markdown-size.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Train/tune safety: reject pathological Markdown (one-line blobs, huge files).
+ * Limits come from {@link getAdapterMarkdownSizeLimits} / config env vars.
+ */
+export interface ValidateAdapterMarkdownSizeOptions {
+    /** When false, skip the full-document line count check (layer body updates). Default true. */
+    enforceMaxLineCount?: boolean;
+}
+export type ValidateAdapterMarkdownSizeResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: string;
+    message: string;
+    details: Record<string, unknown>;
+};
+/**
+ * Validates adapter Markdown (or similar UTF-8 text) before store.
+ * Uses a single pass over `content` after a cheap total-byte check.
+ */
+export declare function validateAdapterMarkdownSize(content: string, options?: ValidateAdapterMarkdownSizeOptions): ValidateAdapterMarkdownSizeResult;
+/** Artifact bodies: total-byte ceiling only (same as markdown composite cap). */
+export declare function validateArtifactContentSize(content: string): ValidateAdapterMarkdownSizeResult;
+//# sourceMappingURL=validate-adapter-markdown-size.d.ts.map

package/dist/services/memory/validate-adapter-markdown-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-adapter-markdown-size.d.ts","sourceRoot":"","sources":["../../../src/services/memory/validate-adapter-markdown-size.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,WAAW,kCAAkC;IACjD,8FAA8F;IAC9F,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,MAAM,iCAAiC,GACzC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACE,EAAE,EAAE,KAAK,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAMN;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,kCAAkC,GAC3C,iCAAiC,CAwEnC;AAED,iFAAiF;AACjF,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,iCAAiC,CAe9F"}

package/dist/services/memory/validate-adapter-markdown-size.js

@@ -0,0 +1,95 @@
+/**
+ * Train/tune safety: reject pathological Markdown (one-line blobs, huge files).
+ * Limits come from {@link getAdapterMarkdownSizeLimits} / config env vars.
+ */
+import { getAdapterMarkdownSizeLimits } from '../../config/adapter-markdown-size-limits.js';
+function sliceLine(content, lineStart, i) {
+    return content.slice(lineStart, i);
+}
+/**
+ * Validates adapter Markdown (or similar UTF-8 text) before store.
+ * Uses a single pass over `content` after a cheap total-byte check.
+ */
+export function validateAdapterMarkdownSize(content, options) {
+    const limits = getAdapterMarkdownSizeLimits();
+    const enforceLineCount = options?.enforceMaxLineCount !== false;
+    const totalBytes = Buffer.byteLength(content, 'utf8');
+    if (totalBytes > limits.maxTotalBytes) {
+        return {
+            ok: false,
+            code: 'ADAPTER_MARKDOWN_TOTAL_BYTES_EXCEEDED',
+            message: `Adapter markdown exceeds maximum total size (${limits.maxTotalBytes} UTF-8 bytes, got ${totalBytes}).`,
+            details: {
+                max_total_bytes: limits.maxTotalBytes,
+                total_bytes: totalBytes,
+                max_lines: limits.maxLines,
+                max_line_bytes: limits.maxLineBytes,
+                safety_factor: limits.safetyFactor
+            }
+        };
+    }
+    let lineStart = 0;
+    let lineIndex = 0;
+    const len = content.length;
+    for (let i = 0; i <= len; i++) {
+        const atEnd = i === len;
+        const c = atEnd ? -1 : content.charCodeAt(i);
+        const isLf = c === 10;
+        const isCr = c === 13;
+        if (!atEnd && !isLf && !isCr) {
+            continue;
+        }
+        const line = sliceLine(content, lineStart, i);
+        const lineBytes = Buffer.byteLength(line, 'utf8');
+        if (lineBytes > limits.maxLineBytes) {
+            return {
+                ok: false,
+                code: 'ADAPTER_MARKDOWN_LINE_TOO_LONG',
+                message: `Line ${lineIndex + 1} exceeds maximum UTF-8 length (${limits.maxLineBytes} bytes, got ${lineBytes}).`,
+                details: {
+                    line_index: lineIndex,
+                    line_bytes: lineBytes,
+                    max_line_bytes: limits.maxLineBytes
+                }
+            };
+        }
+        lineIndex++;
+        if (enforceLineCount && lineIndex > limits.maxLines) {
+            return {
+                ok: false,
+                code: 'ADAPTER_MARKDOWN_LINE_COUNT_EXCEEDED',
+                message: `Adapter markdown exceeds maximum line count (${limits.maxLines} lines, saw at least ${lineIndex}).`,
+                details: {
+                    line_count_at_least: lineIndex,
+                    max_lines: limits.maxLines
+                }
+            };
+        }
+        if (atEnd) {
+            break;
+        }
+        if (isCr && i + 1 < len && content.charCodeAt(i + 1) === 10) {
+            i++;
+        }
+        lineStart = i + 1;
+    }
+    return { ok: true };
+}
+/** Artifact bodies: total-byte ceiling only (same as markdown composite cap). */
+export function validateArtifactContentSize(content) {
+    const limits = getAdapterMarkdownSizeLimits();
+    const totalBytes = Buffer.byteLength(content, 'utf8');
+    if (totalBytes > limits.maxTotalBytes) {
+        return {
+            ok: false,
+            code: 'ARTIFACT_CONTENT_TOTAL_BYTES_EXCEEDED',
+            message: `Artifact content exceeds maximum size (${limits.maxTotalBytes} UTF-8 bytes, got ${totalBytes}).`,
+            details: {
+                max_total_bytes: limits.maxTotalBytes,
+                total_bytes: totalBytes
+            }
+        };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=validate-adapter-markdown-size.js.map

package/dist/services/memory/validate-adapter-markdown-size.js.map

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