n8n-nodes-engram 0.2.0

package/dist/search/HybridSearchEngine.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HybridSearchEngine = void 0;
+const RRF_K = 60;
+class HybridSearchEngine {
+    constructor(storage, embeddingService) {
+        this.storage = storage;
+        this.embeddingService = embeddingService !== null && embeddingService !== void 0 ? embeddingService : null;
+    }
+    async search(query, groupId, options) {
+        var _a, _b, _c;
+        const limit = (_a = options === null || options === void 0 ? void 0 : options.limit) !== null && _a !== void 0 ? _a : 10;
+        const minScore = (_b = options === null || options === void 0 ? void 0 : options.minScore) !== null && _b !== void 0 ? _b : 0;
+        const textPromise = Promise.all([
+            this.storage.searchEntities(query, groupId, {
+                limit: limit * 2,
+                min_score: minScore,
+                entity_type: options === null || options === void 0 ? void 0 : options.entityType,
+            }),
+            this.storage.searchEdges(query, groupId, {
+                limit: limit * 2,
+                min_score: minScore,
+                include_expired: (_c = options === null || options === void 0 ? void 0 : options.includeExpired) !== null && _c !== void 0 ? _c : false,
+            }),
+        ]);
+        if (this.embeddingService &&
+            this.storage.searchEntitiesByVector &&
+            this.storage.searchEdgesByVector) {
+            try {
+                const embeddingResult = await this.embeddingService.embed(query);
+                const vector = embeddingResult.embedding;
+                const [textResults, vectorResults] = await Promise.all([
+                    textPromise,
+                    Promise.all([
+                        this.storage.searchEntitiesByVector(vector, groupId, {
+                            limit: limit * 2,
+                            min_score: 0.3,
+                        }),
+                        this.storage.searchEdgesByVector(vector, groupId, {
+                            limit: limit * 2,
+                            min_score: 0.3,
+                        }),
+                    ]),
+                ]);
+                const [textEntities, textEdges] = textResults;
+                const [vectorEntities, vectorEdges] = vectorResults;
+                const entities = this.mergeEntityResults(textEntities, vectorEntities, limit);
+                const edges = this.mergeEdgeResults(textEdges, vectorEdges, limit);
+                return { entities, edges };
+            }
+            catch (error) {
+                console.warn('Engram: Embedding search failed, using text-only:', error.message);
+            }
+        }
+        const [entities, edges] = await textPromise;
+        return {
+            entities: entities.slice(0, limit),
+            edges: edges.slice(0, limit),
+        };
+    }
+    async searchEntities(query, groupId, options) {
+        return this.storage.searchEntities(query, groupId, options);
+    }
+    async searchEdges(query, groupId, options) {
+        return this.storage.searchEdges(query, groupId, options);
+    }
+    mergeEntityResults(textResults, vectorResults, limit) {
+        const scores = new Map();
+        for (let i = 0; i < textResults.length; i++) {
+            const r = textResults[i];
+            const rrfScore = 1 / (RRF_K + i + 1);
+            scores.set(r.entity.uuid, { score: rrfScore, entity: r });
+        }
+        for (let i = 0; i < vectorResults.length; i++) {
+            const r = vectorResults[i];
+            const rrfScore = 1 / (RRF_K + i + 1);
+            const existing = scores.get(r.entity.uuid);
+            if (existing) {
+                existing.score += rrfScore;
+            }
+            else {
+                scores.set(r.entity.uuid, { score: rrfScore, entity: r });
+            }
+        }
+        const merged = [...scores.values()]
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit)
+            .map((s) => ({
+            entity: s.entity.entity,
+            score: s.score,
+        }));
+        return merged;
+    }
+    mergeEdgeResults(textResults, vectorResults, limit) {
+        const scores = new Map();
+        for (let i = 0; i < textResults.length; i++) {
+            const r = textResults[i];
+            const rrfScore = 1 / (RRF_K + i + 1);
+            scores.set(r.edge.uuid, { score: rrfScore, result: r });
+        }
+        for (let i = 0; i < vectorResults.length; i++) {
+            const r = vectorResults[i];
+            const rrfScore = 1 / (RRF_K + i + 1);
+            const existing = scores.get(r.edge.uuid);
+            if (existing) {
+                existing.score += rrfScore;
+            }
+            else {
+                scores.set(r.edge.uuid, { score: rrfScore, result: r });
+            }
+        }
+        return [...scores.values()]
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit)
+            .map((s) => ({
+            ...s.result,
+            score: s.score,
+        }));
+    }
+    formatAsContext(results) {
+        const parts = [];
+        if (results.entities.length > 0) {
+            parts.push('Known entities:');
+            for (const r of results.entities) {
+                parts.push('- ' + r.entity.name + ' (' + r.entity.entity_type + '): ' + r.entity.summary);
+            }
+        }
+        if (results.edges.length > 0) {
+            if (parts.length > 0)
+                parts.push('');
+            parts.push('Known facts:');
+            for (const r of results.edges) {
+                parts.push('- ' + r.sourceEntity.name + ' -> ' + r.targetEntity.name + ': ' + r.edge.fact);
+            }
+        }
+        return parts.join('\n');
+    }
+}
+exports.HybridSearchEngine = HybridSearchEngine;
+//# sourceMappingURL=HybridSearchEngine.js.map

package/dist/search/HybridSearchEngine.js.map

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

package/dist/search/MinisearchProvider.d.ts

@@ -0,0 +1,20 @@
+import type { TextSearchProvider, TextSearchResult } from './TextSearchProvider';
+export declare class MinisearchProvider implements TextSearchProvider {
+    private entityIndex;
+    private edgeIndex;
+    constructor();
+    indexEntity(id: string, fields: {
+        name: string;
+        summary: string;
+        entity_type: string;
+    }): void;
+    indexEdge(id: string, fields: {
+        name: string;
+        fact: string;
+    }): void;
+    removeEntity(id: string): void;
+    removeEdge(id: string): void;
+    searchEntities(query: string, limit: number): TextSearchResult[];
+    searchEdges(query: string, limit: number): TextSearchResult[];
+    clear(): void;
+}

package/dist/search/MinisearchProvider.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MinisearchProvider = void 0;
+const minisearch_1 = __importDefault(require("minisearch"));
+class MinisearchProvider {
+    constructor() {
+        this.entityIndex = new minisearch_1.default({
+            fields: ['name', 'summary', 'entity_type'],
+            storeFields: ['name', 'summary', 'entity_type'],
+            searchOptions: {
+                boost: { name: 3, summary: 1, entity_type: 0.5 },
+                fuzzy: 0.2,
+                prefix: true,
+            },
+        });
+        this.edgeIndex = new minisearch_1.default({
+            fields: ['name', 'fact'],
+            storeFields: ['name', 'fact'],
+            searchOptions: {
+                boost: { fact: 2, name: 1 },
+                fuzzy: 0.2,
+                prefix: true,
+            },
+        });
+    }
+    indexEntity(id, fields) {
+        if (this.entityIndex.has(id)) {
+            this.entityIndex.discard(id);
+        }
+        this.entityIndex.add({ id, ...fields });
+    }
+    indexEdge(id, fields) {
+        if (this.edgeIndex.has(id)) {
+            this.edgeIndex.discard(id);
+        }
+        this.edgeIndex.add({ id, ...fields });
+    }
+    removeEntity(id) {
+        if (this.entityIndex.has(id)) {
+            this.entityIndex.discard(id);
+        }
+    }
+    removeEdge(id) {
+        if (this.edgeIndex.has(id)) {
+            this.edgeIndex.discard(id);
+        }
+    }
+    searchEntities(query, limit) {
+        if (!query.trim())
+            return [];
+        const results = this.entityIndex.search(query);
+        const maxScore = results.length > 0 ? results[0].score : 1;
+        return results.slice(0, limit).map((r) => ({
+            id: r.id,
+            score: maxScore > 0 ? r.score / maxScore : 0,
+        }));
+    }
+    searchEdges(query, limit) {
+        if (!query.trim())
+            return [];
+        const results = this.edgeIndex.search(query);
+        const maxScore = results.length > 0 ? results[0].score : 1;
+        return results.slice(0, limit).map((r) => ({
+            id: r.id,
+            score: maxScore > 0 ? r.score / maxScore : 0,
+        }));
+    }
+    clear() {
+        this.entityIndex.removeAll();
+        this.edgeIndex.removeAll();
+    }
+}
+exports.MinisearchProvider = MinisearchProvider;
+//# sourceMappingURL=MinisearchProvider.js.map

package/dist/search/MinisearchProvider.js.map

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

package/dist/search/TextSearchProvider.d.ts

@@ -0,0 +1,20 @@
+export interface TextSearchResult {
+    id: string;
+    score: number;
+}
+export interface TextSearchProvider {
+    indexEntity(id: string, fields: {
+        name: string;
+        summary: string;
+        entity_type: string;
+    }): void;
+    indexEdge(id: string, fields: {
+        name: string;
+        fact: string;
+    }): void;
+    removeEntity(id: string): void;
+    removeEdge(id: string): void;
+    searchEntities(query: string, limit: number): TextSearchResult[];
+    searchEdges(query: string, limit: number): TextSearchResult[];
+    clear(): void;
+}

package/dist/search/TextSearchProvider.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TextSearchProvider.js.map

package/dist/search/TextSearchProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextSearchProvider.js","sourceRoot":"","sources":["../../src/search/TextSearchProvider.ts"],"names":[],"mappings":""}

package/dist/search/index.d.ts

@@ -0,0 +1,3 @@
+export type { TextSearchProvider, TextSearchResult } from './TextSearchProvider';
+export { MinisearchProvider } from './MinisearchProvider';
+export { HybridSearchEngine, type HybridSearchOptions, type HybridSearchResults, } from './HybridSearchEngine';

package/dist/search/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HybridSearchEngine = exports.MinisearchProvider = void 0;
+var MinisearchProvider_1 = require("./MinisearchProvider");
+Object.defineProperty(exports, "MinisearchProvider", { enumerable: true, get: function () { return MinisearchProvider_1.MinisearchProvider; } });
+var HybridSearchEngine_1 = require("./HybridSearchEngine");
+Object.defineProperty(exports, "HybridSearchEngine", { enumerable: true, get: function () { return HybridSearchEngine_1.HybridSearchEngine; } });
+//# sourceMappingURL=index.js.map

package/dist/search/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":";;;AACA,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAC3B,2DAI8B;AAH5B,wHAAA,kBAAkB,OAAA"}

package/dist/storage/GraphologyStorage.d.ts

@@ -0,0 +1,42 @@
+import type { IGraphStorage, EntitySearchResult, EdgeSearchResult, ListOptions, EntitySearchOptions, EdgeSearchOptions, VectorSearchOptions, RetentionPolicy } from './IGraphStorage';
+import type { EntityNode, CreateEntityNode, EntityEdge, CreateEntityEdge, EpisodicNode, CreateEpisodicNode, GraphData, GraphStats } from '../schemas';
+export declare class GraphologyStorage implements IGraphStorage {
+    private graph;
+    private searchProvider;
+    private persistPath;
+    private initialized;
+    private episodeOrder;
+    private nextOrder;
+    constructor(persistPath?: string);
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    addEntity(input: CreateEntityNode): Promise<EntityNode>;
+    getEntity(uuid: string): Promise<EntityNode | null>;
+    getEntityByName(name: string, groupId: string): Promise<EntityNode | null>;
+    updateEntity(uuid: string, updates: Partial<EntityNode>): Promise<EntityNode>;
+    deleteEntity(uuid: string): Promise<void>;
+    listEntities(groupId: string, options?: ListOptions): Promise<EntityNode[]>;
+    addEdge(input: CreateEntityEdge): Promise<EntityEdge>;
+    getEdge(uuid: string): Promise<EntityEdge | null>;
+    getEdgesBetween(sourceUuid: string, targetUuid: string): Promise<EntityEdge[]>;
+    getEdgesForEntity(entityUuid: string): Promise<EntityEdge[]>;
+    updateEdge(uuid: string, updates: Partial<EntityEdge>): Promise<EntityEdge>;
+    deleteEdge(uuid: string): Promise<void>;
+    addEpisode(input: CreateEpisodicNode): Promise<EpisodicNode>;
+    getEpisode(uuid: string): Promise<EpisodicNode | null>;
+    getRecentEpisodes(groupId: string, limit: number): Promise<EpisodicNode[]>;
+    getEpisodeCount(groupId: string): Promise<number>;
+    searchEntities(query: string, groupId: string, options?: EntitySearchOptions): Promise<EntitySearchResult[]>;
+    searchEdges(query: string, groupId: string, options?: EdgeSearchOptions): Promise<EdgeSearchResult[]>;
+    searchEntitiesByVector(vector: number[], groupId: string, options?: VectorSearchOptions): Promise<EntitySearchResult[]>;
+    searchEdgesByVector(vector: number[], groupId: string, options?: VectorSearchOptions): Promise<EdgeSearchResult[]>;
+    clearGroup(groupId: string): Promise<void>;
+    clearAll(): Promise<void>;
+    exportGraph(groupId?: string): Promise<GraphData>;
+    importGraph(data: GraphData): Promise<void>;
+    getStats(groupId?: string): Promise<GraphStats>;
+    applyRetention(groupId: string, policy: RetentionPolicy): Promise<number>;
+    private persistIfConfigured;
+    private saveToDisk;
+    private loadFromDisk;
+}