@danielsimonjr/memoryjs 1.0.0

package/dist/utils/indexes.js

@@ -0,0 +1,527 @@
+/**
+ * Search Indexes
+ *
+ * Provides O(1) lookup structures to avoid repeated linear scans.
+ * - NameIndex: O(1) entity lookup by name
+ * - TypeIndex: O(1) entities by type
+ * - LowercaseCache: Pre-computed lowercase strings to avoid repeated toLowerCase()
+ * - RelationIndex: O(1) relation lookup by entity name (from/to)
+ * - ObservationIndex: O(1) observation word lookup by entity
+ *
+ * @module utils/indexes
+ */
+/**
+ * NameIndex provides O(1) entity lookup by name.
+ *
+ * Uses a Map internally for constant-time access.
+ */
+export class NameIndex {
+    index = new Map();
+    /**
+     * Build the index from an array of entities.
+     * Clears any existing index data first.
+     */
+    build(entities) {
+        this.index.clear();
+        for (const entity of entities) {
+            this.index.set(entity.name, entity);
+        }
+    }
+    /**
+     * Get an entity by name in O(1) time.
+     */
+    get(name) {
+        return this.index.get(name);
+    }
+    /**
+     * Add a single entity to the index.
+     */
+    add(entity) {
+        this.index.set(entity.name, entity);
+    }
+    /**
+     * Remove an entity from the index by name.
+     */
+    remove(name) {
+        this.index.delete(name);
+    }
+    /**
+     * Check if an entity exists in the index.
+     */
+    has(name) {
+        return this.index.has(name);
+    }
+    /**
+     * Get the number of entities in the index.
+     */
+    get size() {
+        return this.index.size;
+    }
+    /**
+     * Clear all entries from the index.
+     */
+    clear() {
+        this.index.clear();
+    }
+}
+/**
+ * TypeIndex provides O(1) lookup of entities by type.
+ *
+ * Uses a Map<type, Set<entityName>> structure for efficient type queries.
+ * Type comparisons are case-insensitive.
+ */
+export class TypeIndex {
+    index = new Map();
+    /**
+     * Build the index from an array of entities.
+     * Clears any existing index data first.
+     */
+    build(entities) {
+        this.index.clear();
+        for (const entity of entities) {
+            this.addToIndex(entity.name, entity.entityType);
+        }
+    }
+    /**
+     * Get all entity names of a given type in O(1) time.
+     * Type comparison is case-insensitive.
+     */
+    getNames(entityType) {
+        const typeLower = entityType.toLowerCase();
+        return this.index.get(typeLower) ?? new Set();
+    }
+    /**
+     * Add an entity to the type index.
+     */
+    add(entity) {
+        this.addToIndex(entity.name, entity.entityType);
+    }
+    /**
+     * Remove an entity from the type index.
+     * Requires the entity type to know which bucket to remove from.
+     */
+    remove(entityName, entityType) {
+        const typeLower = entityType.toLowerCase();
+        const names = this.index.get(typeLower);
+        if (names) {
+            names.delete(entityName);
+            if (names.size === 0) {
+                this.index.delete(typeLower);
+            }
+        }
+    }
+    /**
+     * Update an entity's type in the index.
+     * Removes from old type and adds to new type.
+     */
+    updateType(entityName, oldType, newType) {
+        this.remove(entityName, oldType);
+        this.addToIndex(entityName, newType);
+    }
+    /**
+     * Get all unique types in the index.
+     */
+    getTypes() {
+        return Array.from(this.index.keys());
+    }
+    /**
+     * Clear all entries from the index.
+     */
+    clear() {
+        this.index.clear();
+    }
+    addToIndex(entityName, entityType) {
+        const typeLower = entityType.toLowerCase();
+        let names = this.index.get(typeLower);
+        if (!names) {
+            names = new Set();
+            this.index.set(typeLower, names);
+        }
+        names.add(entityName);
+    }
+}
+/**
+ * LowercaseCache pre-computes lowercase versions of all searchable fields.
+ *
+ * Eliminates the need for repeated toLowerCase() calls during search,
+ * which is expensive with many entities and observations.
+ */
+export class LowercaseCache {
+    cache = new Map();
+    /**
+     * Build the cache from an array of entities.
+     * Clears any existing cache data first.
+     */
+    build(entities) {
+        this.cache.clear();
+        for (const entity of entities) {
+            this.cache.set(entity.name, this.computeLowercase(entity));
+        }
+    }
+    /**
+     * Get pre-computed lowercase data for an entity.
+     */
+    get(entityName) {
+        return this.cache.get(entityName);
+    }
+    /**
+     * Add or update an entity in the cache.
+     */
+    set(entity) {
+        this.cache.set(entity.name, this.computeLowercase(entity));
+    }
+    /**
+     * Remove an entity from the cache.
+     */
+    remove(entityName) {
+        this.cache.delete(entityName);
+    }
+    /**
+     * Check if an entity exists in the cache.
+     */
+    has(entityName) {
+        return this.cache.has(entityName);
+    }
+    /**
+     * Clear all entries from the cache.
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get the number of entries in the cache.
+     */
+    get size() {
+        return this.cache.size;
+    }
+    computeLowercase(entity) {
+        return {
+            name: entity.name.toLowerCase(),
+            entityType: entity.entityType.toLowerCase(),
+            observations: entity.observations.map(o => o.toLowerCase()),
+            tags: entity.tags?.map(t => t.toLowerCase()) ?? [],
+        };
+    }
+}
+/**
+ * RelationIndex provides O(1) lookup of relations by entity name.
+ *
+ * Maintains two separate indexes for efficient directional queries:
+ * - fromIndex: Map from source entity name to its outgoing relations
+ * - toIndex: Map from target entity name to its incoming relations
+ *
+ * This eliminates O(n) array scans when looking up relations for an entity.
+ */
+export class RelationIndex {
+    /** Index of relations by source (from) entity */
+    fromIndex = new Map();
+    /** Index of relations by target (to) entity */
+    toIndex = new Map();
+    /**
+     * Build the index from an array of relations.
+     * Clears any existing index data first.
+     */
+    build(relations) {
+        this.fromIndex.clear();
+        this.toIndex.clear();
+        for (const relation of relations) {
+            this.addToIndexes(relation);
+        }
+    }
+    /**
+     * Get all relations where the entity is the source (outgoing relations).
+     * Returns empty array if no relations found.
+     */
+    getRelationsFrom(entityName) {
+        const relations = this.fromIndex.get(entityName);
+        return relations ? Array.from(relations) : [];
+    }
+    /**
+     * Get all relations where the entity is the target (incoming relations).
+     * Returns empty array if no relations found.
+     */
+    getRelationsTo(entityName) {
+        const relations = this.toIndex.get(entityName);
+        return relations ? Array.from(relations) : [];
+    }
+    /**
+     * Get all relations involving the entity (both incoming and outgoing).
+     * Returns empty array if no relations found.
+     */
+    getRelationsFor(entityName) {
+        const fromRelations = this.fromIndex.get(entityName);
+        const toRelations = this.toIndex.get(entityName);
+        // Combine sets to handle self-referential relations correctly
+        const combined = new Set();
+        if (fromRelations) {
+            for (const r of fromRelations) {
+                combined.add(r);
+            }
+        }
+        if (toRelations) {
+            for (const r of toRelations) {
+                combined.add(r);
+            }
+        }
+        return Array.from(combined);
+    }
+    /**
+     * Add a single relation to the index.
+     */
+    add(relation) {
+        this.addToIndexes(relation);
+    }
+    /**
+     * Remove a relation from the index.
+     * Matches by from, to, and relationType.
+     */
+    remove(relation) {
+        // Remove from fromIndex
+        const fromRelations = this.fromIndex.get(relation.from);
+        if (fromRelations) {
+            for (const r of fromRelations) {
+                if (r.from === relation.from && r.to === relation.to && r.relationType === relation.relationType) {
+                    fromRelations.delete(r);
+                    break;
+                }
+            }
+            if (fromRelations.size === 0) {
+                this.fromIndex.delete(relation.from);
+            }
+        }
+        // Remove from toIndex
+        const toRelations = this.toIndex.get(relation.to);
+        if (toRelations) {
+            for (const r of toRelations) {
+                if (r.from === relation.from && r.to === relation.to && r.relationType === relation.relationType) {
+                    toRelations.delete(r);
+                    break;
+                }
+            }
+            if (toRelations.size === 0) {
+                this.toIndex.delete(relation.to);
+            }
+        }
+    }
+    /**
+     * Remove all relations involving a specific entity.
+     * Returns the relations that were removed.
+     */
+    removeAllForEntity(entityName) {
+        const removed = [];
+        // Remove outgoing relations
+        const fromRelations = this.fromIndex.get(entityName);
+        if (fromRelations) {
+            for (const r of fromRelations) {
+                removed.push(r);
+                // Also remove from toIndex
+                const toRels = this.toIndex.get(r.to);
+                if (toRels) {
+                    toRels.delete(r);
+                    if (toRels.size === 0) {
+                        this.toIndex.delete(r.to);
+                    }
+                }
+            }
+            this.fromIndex.delete(entityName);
+        }
+        // Remove incoming relations
+        const toRelations = this.toIndex.get(entityName);
+        if (toRelations) {
+            for (const r of toRelations) {
+                // Skip self-referential relations (already handled above)
+                if (r.from === entityName)
+                    continue;
+                removed.push(r);
+                // Also remove from fromIndex
+                const fromRels = this.fromIndex.get(r.from);
+                if (fromRels) {
+                    fromRels.delete(r);
+                    if (fromRels.size === 0) {
+                        this.fromIndex.delete(r.from);
+                    }
+                }
+            }
+            this.toIndex.delete(entityName);
+        }
+        return removed;
+    }
+    /**
+     * Check if any relations exist for an entity.
+     */
+    hasRelations(entityName) {
+        return this.fromIndex.has(entityName) || this.toIndex.has(entityName);
+    }
+    /**
+     * Get count of outgoing relations for an entity.
+     */
+    getOutgoingCount(entityName) {
+        return this.fromIndex.get(entityName)?.size ?? 0;
+    }
+    /**
+     * Get count of incoming relations for an entity.
+     */
+    getIncomingCount(entityName) {
+        return this.toIndex.get(entityName)?.size ?? 0;
+    }
+    /**
+     * Get total count of unique relations in the index.
+     */
+    get size() {
+        // Count all relations in fromIndex (each relation appears exactly once there)
+        let count = 0;
+        for (const relations of this.fromIndex.values()) {
+            count += relations.size;
+        }
+        return count;
+    }
+    /**
+     * Clear all entries from the index.
+     */
+    clear() {
+        this.fromIndex.clear();
+        this.toIndex.clear();
+    }
+    addToIndexes(relation) {
+        // Add to fromIndex
+        let fromSet = this.fromIndex.get(relation.from);
+        if (!fromSet) {
+            fromSet = new Set();
+            this.fromIndex.set(relation.from, fromSet);
+        }
+        fromSet.add(relation);
+        // Add to toIndex
+        let toSet = this.toIndex.get(relation.to);
+        if (!toSet) {
+            toSet = new Set();
+            this.toIndex.set(relation.to, toSet);
+        }
+        toSet.add(relation);
+    }
+}
+/**
+ * Inverted index mapping observation keywords to entity names.
+ * Enables O(1) lookup for 'which entities mention word X?' queries.
+ * Words are normalized to lowercase and split on whitespace/punctuation.
+ */
+export class ObservationIndex {
+    index = new Map();
+    entityObservations = new Map();
+    /**
+     * Add an entity's observations to the index.
+     * Tokenizes observations into words and creates reverse mapping.
+     *
+     * @param entityName - Name of the entity
+     * @param observations - Array of observation strings
+     */
+    add(entityName, observations) {
+        const entityWords = new Set();
+        for (const observation of observations) {
+            const words = this.tokenize(observation);
+            for (const word of words) {
+                entityWords.add(word);
+                if (!this.index.has(word)) {
+                    this.index.set(word, new Set());
+                }
+                this.index.get(word).add(entityName);
+            }
+        }
+        this.entityObservations.set(entityName, entityWords);
+    }
+    /**
+     * Remove an entity from the index.
+     * Cleans up all word mappings for this entity.
+     *
+     * @param entityName - Name of the entity to remove
+     */
+    remove(entityName) {
+        const words = this.entityObservations.get(entityName);
+        if (!words)
+            return;
+        for (const word of words) {
+            const entities = this.index.get(word);
+            if (entities) {
+                entities.delete(entityName);
+                if (entities.size === 0) {
+                    this.index.delete(word);
+                }
+            }
+        }
+        this.entityObservations.delete(entityName);
+    }
+    /**
+     * Get all entities that have observations containing the given word.
+     * Word matching is case-insensitive.
+     *
+     * @param word - Word to search for
+     * @returns Set of entity names containing this word
+     */
+    getEntitiesWithWord(word) {
+        return this.index.get(word.toLowerCase()) ?? new Set();
+    }
+    /**
+     * Get all entities that have observations containing ANY of the given words (union).
+     *
+     * @param words - Array of words to search for
+     * @returns Set of entity names containing any of the words
+     */
+    getEntitiesWithAnyWord(words) {
+        const result = new Set();
+        for (const word of words) {
+            const entities = this.getEntitiesWithWord(word);
+            for (const entity of entities) {
+                result.add(entity);
+            }
+        }
+        return result;
+    }
+    /**
+     * Get all entities that have observations containing ALL of the given words (intersection).
+     *
+     * @param words - Array of words that must all be present
+     * @returns Set of entity names containing all of the words
+     */
+    getEntitiesWithAllWords(words) {
+        if (words.length === 0)
+            return new Set();
+        let result = new Set(this.getEntitiesWithWord(words[0]));
+        for (let i = 1; i < words.length && result.size > 0; i++) {
+            const wordEntities = this.getEntitiesWithWord(words[i]);
+            result = new Set([...result].filter(e => wordEntities.has(e)));
+        }
+        return result;
+    }
+    /**
+     * Clear all entries from the index.
+     */
+    clear() {
+        this.index.clear();
+        this.entityObservations.clear();
+    }
+    /**
+     * Get statistics about the index.
+     *
+     * @returns Object with wordCount and entityCount
+     */
+    getStats() {
+        return {
+            wordCount: this.index.size,
+            entityCount: this.entityObservations.size,
+        };
+    }
+    /**
+     * Tokenize text into searchable words.
+     * Normalizes to lowercase, splits on non-alphanumeric characters,
+     * and filters out words less than 2 characters.
+     *
+     * @param text - Text to tokenize
+     * @returns Array of normalized words
+     */
+    tokenize(text) {
+        return text
+            .toLowerCase()
+            .split(/[^a-z0-9]+/)
+            .filter(word => word.length >= 2);
+    }
+}
+//# sourceMappingURL=indexes.js.map

package/dist/utils/indexes.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Simple logging utility for the Memory MCP Server
+ *
+ * Provides consistent log formatting with levels: debug, info, warn, error
+ *
+ * IMPORTANT: All log output goes to stderr to avoid interfering with
+ * JSON-RPC communication on stdout when running as an MCP server.
+ */
+export declare const logger: {
+    /**
+     * Debug level logging (verbose, for development)
+     * Output: stderr (to avoid interfering with JSON-RPC)
+     */
+    debug: (msg: string, ...args: unknown[]) => void;
+    /**
+     * Info level logging (general informational messages)
+     * Output: stderr (to avoid interfering with JSON-RPC)
+     */
+    info: (msg: string, ...args: unknown[]) => void;
+    /**
+     * Warning level logging (warnings that don't prevent operation)
+     * Output: stderr (native console.warn behavior)
+     */
+    warn: (msg: string, ...args: unknown[]) => void;
+    /**
+     * Error level logging (errors that affect functionality)
+     * Output: stderr (native console.error behavior)
+     */
+    error: (msg: string, ...args: unknown[]) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,MAAM;IACjB;;;OAGG;iBACU,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;IAM9C;;;OAGG;gBACS,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;IAI7C;;;OAGG;gBACS,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;IAI7C;;;OAGG;iBACU,MAAM,WAAW,OAAO,EAAE,KAAG,IAAI;CAG/C,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,41 @@
+/**
+ * Simple logging utility for the Memory MCP Server
+ *
+ * Provides consistent log formatting with levels: debug, info, warn, error
+ *
+ * IMPORTANT: All log output goes to stderr to avoid interfering with
+ * JSON-RPC communication on stdout when running as an MCP server.
+ */
+export const logger = {
+    /**
+     * Debug level logging (verbose, for development)
+     * Output: stderr (to avoid interfering with JSON-RPC)
+     */
+    debug: (msg, ...args) => {
+        if (process.env.LOG_LEVEL === 'debug') {
+            console.error(`[DEBUG] ${msg}`, ...args);
+        }
+    },
+    /**
+     * Info level logging (general informational messages)
+     * Output: stderr (to avoid interfering with JSON-RPC)
+     */
+    info: (msg, ...args) => {
+        console.error(`[INFO] ${msg}`, ...args);
+    },
+    /**
+     * Warning level logging (warnings that don't prevent operation)
+     * Output: stderr (native console.warn behavior)
+     */
+    warn: (msg, ...args) => {
+        console.warn(`[WARN] ${msg}`, ...args);
+    },
+    /**
+     * Error level logging (errors that affect functionality)
+     * Output: stderr (native console.error behavior)
+     */
+    error: (msg, ...args) => {
+        console.error(`[ERROR] ${msg}`, ...args);
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB;;;OAGG;IACH,KAAK,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAQ,EAAE;QAC/C,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAQ,EAAE;QAC9C,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,IAAI,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAQ,EAAE;QAC9C,OAAO,CAAC,IAAI,CAAC,UAAU,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;;OAGG;IACH,KAAK,EAAE,CAAC,GAAW,EAAE,GAAG,IAAe,EAAQ,EAAE;QAC/C,OAAO,CAAC,KAAK,CAAC,WAAW,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF,CAAC"}