@danielsimonjr/memory-mcp 11.1.1 → 12.5.2

package/dist/search/VectorStore.js

@@ -1,311 +0,0 @@
-/**
- * Vector Store
- *
- * Phase 4 Sprint 11: Vector storage and retrieval for semantic search.
- * Provides in-memory and SQLite-backed implementations.
- *
- * @module search/VectorStore
- */
-/**
- * Calculate cosine similarity between two vectors.
- *
- * Uses an optimized inner loop without array methods for maximum performance.
- *
- * @param a - First vector
- * @param b - Second vector
- * @returns Cosine similarity score (0.0 to 1.0)
- */
-export function cosineSimilarity(a, b) {
-    if (a.length !== b.length) {
-        throw new Error(`Vector dimensions mismatch: ${a.length} vs ${b.length}`);
-    }
-    let dotProduct = 0;
-    let magnitudeA = 0;
-    let magnitudeB = 0;
-    // Optimized single-pass loop
-    for (let i = 0; i < a.length; i++) {
-        const ai = a[i];
-        const bi = b[i];
-        dotProduct += ai * bi;
-        magnitudeA += ai * ai;
-        magnitudeB += bi * bi;
-    }
-    const magnitude = Math.sqrt(magnitudeA) * Math.sqrt(magnitudeB);
-    if (magnitude === 0) {
-        return 0;
-    }
-    // Clamp to [-1, 1] to handle floating point errors
-    const similarity = dotProduct / magnitude;
-    return Math.max(-1, Math.min(1, similarity));
-}
-/**
- * In-Memory Vector Store
- *
- * Stores vectors in memory using a Map for O(1) add/remove operations.
- * Search uses brute-force cosine similarity which is O(n) but fast for
- * small to medium graphs (<10K entities).
- *
- * @example
- * ```typescript
- * const store = new InMemoryVectorStore();
- * store.add("entity1", [0.1, 0.2, 0.3]);
- * store.add("entity2", [0.4, 0.5, 0.6]);
- * const results = store.search([0.1, 0.2, 0.3], 5);
- * console.log(results); // [{ name: "entity1", score: 1.0 }, ...]
- * ```
- */
-export class InMemoryVectorStore {
-    /** Map of entity name to embedding vector */
-    vectors = new Map();
-    /**
-     * Add a vector for an entity.
-     *
-     * @param entityName - Name of the entity
-     * @param vector - Embedding vector
-     */
-    add(entityName, vector) {
-        this.vectors.set(entityName, vector);
-    }
-    /**
-     * Search for similar vectors using cosine similarity.
-     *
-     * @param queryVector - Query embedding vector
-     * @param k - Number of results to return
-     * @returns Array of results with entity name and similarity score
-     */
-    search(queryVector, k) {
-        if (this.vectors.size === 0) {
-            return [];
-        }
-        // Calculate similarity for all vectors
-        const results = [];
-        for (const [name, vector] of this.vectors) {
-            try {
-                const score = cosineSimilarity(queryVector, vector);
-                results.push({ name, score });
-            }
-            catch {
-                // Skip vectors with dimension mismatch
-                continue;
-            }
-        }
-        // Sort by score descending and take top k
-        results.sort((a, b) => b.score - a.score);
-        return results.slice(0, k);
-    }
-    /**
-     * Remove a vector by entity name.
-     *
-     * @param entityName - Name of the entity to remove
-     * @returns True if found and removed
-     */
-    remove(entityName) {
-        return this.vectors.delete(entityName);
-    }
-    /**
-     * Get the number of vectors stored.
-     *
-     * @returns Number of vectors
-     */
-    size() {
-        return this.vectors.size;
-    }
-    /**
-     * Clear all vectors from the store.
-     */
-    clear() {
-        this.vectors.clear();
-    }
-    /**
-     * Check if a vector exists for an entity.
-     *
-     * @param entityName - Name of the entity
-     * @returns True if vector exists
-     */
-    has(entityName) {
-        return this.vectors.has(entityName);
-    }
-    /**
-     * Get the vector for an entity.
-     *
-     * @param entityName - Name of the entity
-     * @returns Vector if found, undefined otherwise
-     */
-    get(entityName) {
-        return this.vectors.get(entityName);
-    }
-    /**
-     * Get all entity names with stored vectors.
-     *
-     * @returns Array of entity names
-     */
-    getEntityNames() {
-        return Array.from(this.vectors.keys());
-    }
-    /**
-     * Load vectors from an iterable source.
-     *
-     * @param entries - Iterable of [entityName, vector] pairs
-     */
-    loadFrom(entries) {
-        for (const [name, vector] of entries) {
-            this.vectors.set(name, vector);
-        }
-    }
-}
-/**
- * SQLite Vector Store
- *
- * Persists vectors to SQLite storage while maintaining an in-memory cache
- * for fast search operations. Combines persistence with performance.
- *
- * Uses SQLiteStorage's embedding storage methods for persistence.
- *
- * @example
- * ```typescript
- * const store = new SQLiteVectorStore(sqliteStorage);
- * await store.initialize();
- * store.add("entity1", [0.1, 0.2, 0.3]);
- * const results = store.search([0.1, 0.2, 0.3], 5);
- * ```
- */
-export class SQLiteVectorStore {
-    /** In-memory cache for fast search */
-    memoryStore = new InMemoryVectorStore();
-    /** SQLite storage reference for persistence */
-    storage = null;
-    /** Whether the store has been initialized */
-    initialized = false;
-    /** Model name used for embeddings */
-    embeddingModel = '';
-    /**
-     * Create a SQLite vector store.
-     *
-     * @param storage - SQLite storage instance with embedding support
-     * @param embeddingModel - Model name used for embeddings
-     */
-    constructor(storage, embeddingModel = 'unknown') {
-        this.storage = storage || null;
-        this.embeddingModel = embeddingModel;
-    }
-    /**
-     * Initialize the store by loading vectors from SQLite.
-     */
-    async initialize() {
-        if (this.initialized)
-            return;
-        if (this.storage) {
-            // Load all embeddings from SQLite
-            const embeddings = await this.storage.loadAllEmbeddings();
-            this.memoryStore.loadFrom(embeddings);
-        }
-        this.initialized = true;
-    }
-    /**
-     * Add a vector for an entity.
-     * Stores in both memory and SQLite for persistence.
-     *
-     * @param entityName - Name of the entity
-     * @param vector - Embedding vector
-     */
-    add(entityName, vector) {
-        // Add to in-memory cache
-        this.memoryStore.add(entityName, vector);
-        // Persist to SQLite if available
-        if (this.storage) {
-            this.storage.storeEmbedding(entityName, vector, this.embeddingModel);
-        }
-    }
-    /**
-     * Search for similar vectors using cosine similarity.
-     *
-     * @param queryVector - Query embedding vector
-     * @param k - Number of results to return
-     * @returns Array of results with entity name and similarity score
-     */
-    search(queryVector, k) {
-        return this.memoryStore.search(queryVector, k);
-    }
-    /**
-     * Remove a vector by entity name.
-     *
-     * @param entityName - Name of the entity to remove
-     * @returns True if found and removed
-     */
-    remove(entityName) {
-        const removed = this.memoryStore.remove(entityName);
-        // Remove from SQLite if available
-        if (this.storage && removed) {
-            this.storage.removeEmbedding(entityName);
-        }
-        return removed;
-    }
-    /**
-     * Get the number of vectors stored.
-     *
-     * @returns Number of vectors
-     */
-    size() {
-        return this.memoryStore.size();
-    }
-    /**
-     * Clear all vectors from the store.
-     */
-    clear() {
-        this.memoryStore.clear();
-        if (this.storage) {
-            this.storage.clearAllEmbeddings();
-        }
-    }
-    /**
-     * Check if a vector exists for an entity.
-     *
-     * @param entityName - Name of the entity
-     * @returns True if vector exists
-     */
-    has(entityName) {
-        return this.memoryStore.has(entityName);
-    }
-    /**
-     * Get the vector for an entity.
-     *
-     * @param entityName - Name of the entity
-     * @returns Vector if found, undefined otherwise
-     */
-    get(entityName) {
-        return this.memoryStore.get(entityName);
-    }
-    /**
-     * Set the SQLite storage reference.
-     *
-     * @param storage - SQLite storage instance
-     */
-    setStorage(storage) {
-        this.storage = storage;
-    }
-    /**
-     * Set the embedding model name.
-     *
-     * @param model - Model name
-     */
-    setEmbeddingModel(model) {
-        this.embeddingModel = model;
-    }
-}
-/**
- * Create a vector store based on storage type.
- *
- * @param storageType - Storage type: 'jsonl' or 'sqlite'
- * @param storage - Optional SQLite storage reference for 'sqlite' type
- * @param embeddingModel - Optional model name for embedding tracking
- * @returns Vector store instance
- */
-export function createVectorStore(storageType = 'jsonl', storage, embeddingModel) {
-    switch (storageType) {
-        case 'sqlite':
-            return new SQLiteVectorStore(storage, embeddingModel);
-        case 'jsonl':
-        default:
-            return new InMemoryVectorStore();
-    }
-}

package/dist/search/index.d.ts

@@ -1,18 +0,0 @@
-/**
- * Search Module Barrel Export
- *
- * Sprint 2: Added SearchFilterChain for centralized filter logic
- * Phase 4 Sprint 10: Added EmbeddingService for semantic search
- */
-export { BasicSearch } from './BasicSearch.js';
-export { RankedSearch } from './RankedSearch.js';
-export { BooleanSearch } from './BooleanSearch.js';
-export { FuzzySearch, type FuzzySearchOptions } from './FuzzySearch.js';
-export { SearchSuggestions } from './SearchSuggestions.js';
-export { SavedSearchManager } from './SavedSearchManager.js';
-export { SearchManager } from './SearchManager.js';
-export { SearchFilterChain, type SearchFilters, type ValidatedPagination } from './SearchFilterChain.js';
-export { OpenAIEmbeddingService, LocalEmbeddingService, MockEmbeddingService, createEmbeddingService, } from './EmbeddingService.js';
-export { InMemoryVectorStore, SQLiteVectorStore, createVectorStore, cosineSimilarity, type SQLiteStorageWithEmbeddings, } from './VectorStore.js';
-export { SemanticSearch, entityToText, } from './SemanticSearch.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/search/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,OAAO,EAAE,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGzG,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,2BAA2B,GACjC,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,cAAc,EACd,YAAY,GACb,MAAM,qBAAqB,CAAC"}

package/dist/search/index.js

@@ -1,21 +0,0 @@
-/**
- * Search Module Barrel Export
- *
- * Sprint 2: Added SearchFilterChain for centralized filter logic
- * Phase 4 Sprint 10: Added EmbeddingService for semantic search
- */
-export { BasicSearch } from './BasicSearch.js';
-export { RankedSearch } from './RankedSearch.js';
-export { BooleanSearch } from './BooleanSearch.js';
-export { FuzzySearch } from './FuzzySearch.js';
-export { SearchSuggestions } from './SearchSuggestions.js';
-export { SavedSearchManager } from './SavedSearchManager.js';
-export { SearchManager } from './SearchManager.js';
-// Sprint 2: Search Filter Chain utilities
-export { SearchFilterChain } from './SearchFilterChain.js';
-// Phase 4 Sprint 10: Embedding Service for semantic search
-export { OpenAIEmbeddingService, LocalEmbeddingService, MockEmbeddingService, createEmbeddingService, } from './EmbeddingService.js';
-// Phase 4 Sprint 11: Vector Store for semantic search
-export { InMemoryVectorStore, SQLiteVectorStore, createVectorStore, cosineSimilarity, } from './VectorStore.js';
-// Phase 4 Sprint 12: Semantic Search Manager
-export { SemanticSearch, entityToText, } from './SemanticSearch.js';

package/dist/types/index.d.ts

@@ -1,13 +0,0 @@
-/**
- * Types Module - Barrel Export
- *
- * Central export point for all type definitions used throughout the
- * Memory MCP Server. All types are consolidated in types.ts (Phase 5 cleanup).
- *
- * @example
- * ```typescript
- * import { Entity, Relation, KnowledgeGraph, SearchResult } from './types/index.js';
- * ```
- */
-export type { Entity, Relation, KnowledgeGraph, ReadonlyKnowledgeGraph, SearchResult, SavedSearch, BooleanQueryNode, DocumentVector, TFIDFIndex, FuzzyCacheKey, BooleanCacheEntry, PaginatedCacheEntry, TokenizedEntity, GraphStats, ValidationReport, ValidationIssue, ValidationWarning, CacheCompressionStats, ArchiveResultExtended, ExportFilter, ExportOptions, ExportResult, ImportResult, CompressionResult, BackupOptions, BackupResult, RestoreResult, BackupMetadataExtended, BackupInfoExtended, TagAlias, IGraphStorage, StorageConfig, LowercaseData, TraversalOptions, TraversalResult, PathResult, ConnectedComponentsResult, CentralityResult, WeightedRelation, EmbeddingService, SemanticSearchResult, IVectorStore, VectorSearchResult, EmbeddingConfig, SemanticIndexOptions, } from './types.js';
-//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EAEV,MAAM,EACN,QAAQ,EACR,cAAc,EACd,sBAAsB,EAEtB,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,UAAU,EAEV,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EAEf,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EAErB,qBAAqB,EAErB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,iBAAiB,EAEjB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAElB,QAAQ,EAER,aAAa,EACb,aAAa,EACb,aAAa,EAEb,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,yBAAyB,EACzB,gBAAgB,EAChB,gBAAgB,EAEhB,gBAAgB,EAChB,oBAAoB,EACpB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC"}

package/dist/types/index.js

@@ -1,12 +0,0 @@
-/**
- * Types Module - Barrel Export
- *
- * Central export point for all type definitions used throughout the
- * Memory MCP Server. All types are consolidated in types.ts (Phase 5 cleanup).
- *
- * @example
- * ```typescript
- * import { Entity, Relation, KnowledgeGraph, SearchResult } from './types/index.js';
- * ```
- */
-export {};