@dollhousemcp/mcp-server 1.8.0 → 1.9.0

package/dist/elements/memories/MemorySearchIndex.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Memory Search Index - High-performance indexed search for Memory elements
+ *
+ * Addresses issue #984: Implement search indexing for Memory element scalability
+ *
+ * Features:
+ * - Tag index for O(1) tag-based queries
+ * - Content index using inverted index pattern
+ * - Temporal index for date range queries
+ * - Privacy level index for filtered access
+ * - Incremental index updates
+ * - Optional persistence
+ * - Configurable thresholds
+ */
+import { MemoryEntry } from './Memory.js';
+import { PrivacyLevel } from './constants.js';
+export interface SearchIndexConfig {
+    /**
+     * Enable indexing when memory has more than this many entries
+     * Default: 100
+     */
+    indexThreshold?: number;
+    /**
+     * Enable content index (more memory intensive)
+     * Default: true
+     */
+    enableContentIndex?: boolean;
+    /**
+     * Maximum number of terms to index per entry
+     * Default: 100
+     */
+    maxTermsPerEntry?: number;
+    /**
+     * Minimum term length to index
+     * Default: 2
+     */
+    minTermLength?: number;
+    /**
+     * Enable index persistence to disk
+     * Default: false
+     */
+    enablePersistence?: boolean;
+    /**
+     * Maximum memory usage in MB
+     * Default: 100
+     */
+    maxMemoryMB?: number;
+    /**
+     * Enable LRU eviction when memory limit is reached
+     * Default: true
+     */
+    enableLRUEviction?: boolean;
+}
+export interface SearchIndexStats {
+    isIndexed: boolean;
+    entryCount: number;
+    tagCount: number;
+    termCount: number;
+    lastBuilt?: Date;
+    buildTimeMs?: number;
+    memoryUsageBytes?: number;
+}
+export interface SearchQuery {
+    tags?: string[];
+    content?: string;
+    dateFrom?: Date;
+    dateTo?: Date;
+    privacyLevel?: PrivacyLevel;
+    limit?: number;
+    offset?: number;
+}
+export interface SearchResult {
+    entry: MemoryEntry;
+    score: number;
+    matches: {
+        tags?: string[];
+        terms?: string[];
+    };
+}
+/**
+ * Main search index for Memory elements
+ */
+export declare class MemorySearchIndex {
+    private readonly config;
+    private tagIndex;
+    private privacyIndex;
+    private contentIndex;
+    private temporalIndex;
+    private entriesCache;
+    private isBuilt;
+    private isBuilding;
+    private buildQueue;
+    private stats;
+    private readonly maxMemoryBytes;
+    private memoryUsageBytes;
+    constructor(config?: SearchIndexConfig);
+    /**
+     * Build or rebuild the index from entries
+     * FIX: Added race condition protection with isBuilding flag and build queue
+     */
+    buildIndex(entries: Map<string, MemoryEntry>): Promise<void>;
+    private _doBuildIndex;
+    /**
+     * Add a single entry to the index (incremental update)
+     */
+    addEntry(entry: MemoryEntry): void;
+    /**
+     * Remove an entry from the index
+     */
+    removeEntry(entryId: string): void;
+    /**
+     * Search the index with multiple criteria
+     */
+    search(query: SearchQuery, entries: Map<string, MemoryEntry>): SearchResult[];
+    /**
+     * Fallback linear search when index is not available
+     */
+    private linearSearch;
+    /**
+     * Internal helper to add entry to all indexes
+     */
+    private addToIndex;
+    /**
+     * Clear all indexes
+     */
+    clear(): void;
+    /**
+     * Get index statistics
+     */
+    getStats(): SearchIndexStats;
+    /**
+     * Check if index is built
+     */
+    get isIndexed(): boolean;
+    /**
+     * Calculate and update memory usage
+     * FIX: Added memory monitoring for content index
+     */
+    private updateMemoryUsage;
+    /**
+     * Evict least recently used entries to free memory
+     * FIX: Added LRU eviction for memory management
+     */
+    private evictLRUEntries;
+    /**
+     * Serialize index to JSON for persistence
+     * FIX: Added index serialization for cold start optimization
+     */
+    serialize(): string;
+    /**
+     * Deserialize index from JSON
+     * FIX: Added index deserialization for faster startup
+     */
+    deserialize(data: string, entries: Map<string, MemoryEntry>): void;
+}
+//# sourceMappingURL=MemorySearchIndex.d.ts.map

package/dist/elements/memories/MemorySearchIndex.d.ts.map

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