n8n-nodes-engram 0.2.0

package/dist/credentials/EngramNeo4jApi.credentials.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EngramNeo4jApi = void 0;
+class EngramNeo4jApi {
+    constructor() {
+        this.name = 'engramNeo4jApi';
+        this.displayName = 'Engram Neo4j Connection';
+        this.documentationUrl = 'https://neo4j.com/docs/';
+        this.properties = [
+            {
+                displayName: 'URI',
+                name: 'uri',
+                type: 'string',
+                default: 'bolt://localhost:7687',
+                placeholder: 'bolt://localhost:7687',
+                description: 'The Neo4j connection URI (bolt:// or neo4j://)',
+            },
+            {
+                displayName: 'Username',
+                name: 'username',
+                type: 'string',
+                default: 'neo4j',
+            },
+            {
+                displayName: 'Password',
+                name: 'password',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+            },
+            {
+                displayName: 'Database',
+                name: 'database',
+                type: 'string',
+                default: 'neo4j',
+                description: 'The Neo4j database to use',
+            },
+        ];
+        this.test = {
+            request: {
+                method: 'POST',
+                baseURL: '={{$credentials.uri.replace("bolt://", "http://").replace("neo4j://", "http://").replace(":7687", ":7474").replace("://localhost:", "://127.0.0.1:")}}',
+                url: '=/db/{{$credentials.database}}/tx/commit',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                auth: {
+                    username: '={{$credentials.username}}',
+                    password: '={{$credentials.password}}',
+                },
+                body: {
+                    statements: [{ statement: 'RETURN 1' }],
+                },
+            },
+        };
+    }
+}
+exports.EngramNeo4jApi = EngramNeo4jApi;
+//# sourceMappingURL=EngramNeo4jApi.credentials.js.map

package/dist/credentials/EngramNeo4jApi.credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EngramNeo4jApi.credentials.js","sourceRoot":"","sources":["../../src/credentials/EngramNeo4jApi.credentials.ts"],"names":[],"mappings":";;;AAEA,MAAa,cAAc;IAA3B;QACE,SAAI,GAAG,gBAAgB,CAAC;QAExB,gBAAW,GAAG,yBAAyB,CAAC;QAExC,qBAAgB,GAAG,yBAAyB,CAAC;QAE7C,eAAU,GAAsB;YAC9B;gBACE,WAAW,EAAE,KAAK;gBAClB,IAAI,EAAE,KAAK;gBACX,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uBAAuB;gBAChC,WAAW,EAAE,uBAAuB;gBACpC,WAAW,EAAE,gDAAgD;aAC9D;YACD;gBACE,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,OAAO;aACjB;YACD;gBACE,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;gBAC/B,OAAO,EAAE,EAAE;aACZ;YACD;gBACE,WAAW,EAAE,UAAU;gBACvB,IAAI,EAAE,UAAU;gBAChB,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,OAAO;gBAChB,WAAW,EAAE,2BAA2B;aACzC;SACF,CAAC;QAGF,SAAI,GAA2B;YAC7B,OAAO,EAAE;gBACP,MAAM,EAAE,MAAM;gBACd,OAAO,EACL,wJAAwJ;gBAC1J,GAAG,EAAE,0CAA0C;gBAC/C,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;iBACnC;gBACD,IAAI,EAAE;oBACJ,QAAQ,EAAE,4BAA4B;oBACtC,QAAQ,EAAE,4BAA4B;iBACvC;gBACD,IAAI,EAAE;oBACJ,UAAU,EAAE,CAAC,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;iBACxC;aACF;SACF,CAAC;IACJ,CAAC;CAAA;AAzDD,wCAyDC"}

package/dist/descriptions.d.ts

@@ -0,0 +1,4 @@
+import type { INodeProperties } from 'n8n-workflow';
+export declare const sessionIdOption: INodeProperties;
+export declare const sessionKeyProperty: INodeProperties;
+export declare const contextWindowLengthProperty: INodeProperties;

package/dist/descriptions.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contextWindowLengthProperty = exports.sessionKeyProperty = exports.sessionIdOption = void 0;
+exports.sessionIdOption = {
+    displayName: 'Session ID',
+    name: 'sessionIdType',
+    type: 'options',
+    options: [
+        {
+            name: 'Take from previous node automatically',
+            value: 'fromInput',
+            description: 'Looks for an input field called sessionId',
+        },
+        {
+            name: 'Define below',
+            value: 'customKey',
+            description: 'Use an expression to reference data in previous nodes or enter static text',
+        },
+    ],
+    default: 'fromInput',
+};
+exports.sessionKeyProperty = {
+    displayName: 'Key',
+    name: 'sessionKey',
+    type: 'string',
+    default: '',
+    description: 'The key to use to store session ID in the memory',
+    displayOptions: {
+        show: {
+            sessionIdType: ['customKey'],
+        },
+    },
+};
+exports.contextWindowLengthProperty = {
+    displayName: 'Context Window Length',
+    name: 'contextWindowLength',
+    type: 'number',
+    default: 5,
+    hint: 'How many past interactions the model receives as context',
+};
+//# sourceMappingURL=descriptions.js.map

package/dist/descriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptions.js","sourceRoot":"","sources":["../src/descriptions.ts"],"names":[],"mappings":";;;AAEa,QAAA,eAAe,GAAoB;IAC9C,WAAW,EAAE,YAAY;IACzB,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,SAAS;IACf,OAAO,EAAE;QACP;YAEE,IAAI,EAAE,uCAAuC;YAC7C,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,2CAA2C;SACzD;QACD;YAEE,IAAI,EAAE,cAAc;YACpB,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,4EAA4E;SAC1F;KACF;IACD,OAAO,EAAE,WAAW;CACrB,CAAC;AAEW,QAAA,kBAAkB,GAAoB;IACjD,WAAW,EAAE,KAAK;IAClB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,EAAE;IACX,WAAW,EAAE,kDAAkD;IAC/D,cAAc,EAAE;QACd,IAAI,EAAE;YACJ,aAAa,EAAE,CAAC,WAAW,CAAC;SAC7B;KACF;CACF,CAAC;AAEW,QAAA,2BAA2B,GAAoB;IAC1D,WAAW,EAAE,uBAAuB;IACpC,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,CAAC;IACV,IAAI,EAAE,0DAA0D;CACjE,CAAC"}

package/dist/embeddings/EmbeddingService.d.ts

@@ -0,0 +1,24 @@
+export interface EmbeddingConfig {
+    apiKey: string;
+    baseUrl: string;
+    model: string;
+    dimensions?: number;
+    timeoutMs?: number;
+}
+export interface EmbeddingResult {
+    embedding: number[];
+    usage?: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+export declare class EmbeddingService {
+    private apiKey;
+    private baseUrl;
+    private model;
+    private dimensions;
+    private timeoutMs;
+    constructor(config: EmbeddingConfig);
+    embed(text: string): Promise<EmbeddingResult>;
+    embedBatch(texts: string[]): Promise<EmbeddingResult[]>;
+}

package/dist/embeddings/EmbeddingService.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmbeddingService = void 0;
+class EmbeddingService {
+    constructor(config) {
+        var _a;
+        this.apiKey = config.apiKey;
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.model = config.model;
+        this.dimensions = config.dimensions;
+        this.timeoutMs = (_a = config.timeoutMs) !== null && _a !== void 0 ? _a : 30000;
+    }
+    async embed(text) {
+        const results = await this.embedBatch([text]);
+        return results[0];
+    }
+    async embedBatch(texts) {
+        if (texts.length === 0)
+            return [];
+        const url = `${this.baseUrl}/embeddings`;
+        const body = {
+            model: this.model,
+            input: texts,
+        };
+        if (this.dimensions) {
+            body.dimensions = this.dimensions;
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+        let response;
+        try {
+            response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify(body),
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new Error(`Embedding API request timed out after ${this.timeoutMs}ms`);
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`Embedding API error (${response.status}): ${errorText}`);
+        }
+        const data = (await response.json());
+        const sorted = [...data.data].sort((a, b) => a.index - b.index);
+        return sorted.map((item) => ({
+            embedding: item.embedding,
+            usage: data.usage,
+        }));
+    }
+}
+exports.EmbeddingService = EmbeddingService;
+//# sourceMappingURL=EmbeddingService.js.map

package/dist/embeddings/EmbeddingService.js.map

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

package/dist/embeddings/cosine.d.ts

@@ -0,0 +1 @@
+export declare function cosineSimilarity(a: number[], b: number[]): number;

package/dist/embeddings/cosine.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cosineSimilarity = cosineSimilarity;
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector dimension mismatch: ${a.length} vs ${b.length}`);
+    }
+    let dotProduct = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dotProduct += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denominator === 0)
+        return 0;
+    return dotProduct / denominator;
+}
+//# sourceMappingURL=cosine.js.map

package/dist/embeddings/cosine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosine.js","sourceRoot":"","sources":["../../src/embeddings/cosine.ts"],"names":[],"mappings":";;AAIA,4CAmBC;AAnBD,SAAgB,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1B,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEhC,OAAO,UAAU,GAAG,WAAW,CAAC;AAClC,CAAC"}

package/dist/embeddings/index.d.ts

@@ -0,0 +1,2 @@
+export { EmbeddingService, type EmbeddingConfig, type EmbeddingResult } from './EmbeddingService';
+export { cosineSimilarity } from './cosine';

package/dist/embeddings/index.js

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

package/dist/embeddings/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/embeddings/index.ts"],"names":[],"mappings":";;;AAAA,uDAAkG;AAAzF,oHAAA,gBAAgB,OAAA;AACzB,mCAA4C;AAAnC,0GAAA,gBAAgB,OAAA"}

package/dist/extraction/ContradictionDetector.d.ts

@@ -0,0 +1,11 @@
+import type { LlmClient } from './LlmClient';
+export interface ContradictionResolution {
+    isContradiction: boolean;
+    explanation?: string;
+    expiredAt?: string;
+}
+export declare class ContradictionDetector {
+    private llm;
+    constructor(llm: LlmClient);
+    detect(existingFact: string, newFact: string, sourceEntity: string, targetEntity: string): Promise<ContradictionResolution>;
+}

package/dist/extraction/ContradictionDetector.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContradictionDetector = void 0;
+const prompts_1 = require("./prompts");
+const temporal_1 = require("../utils/temporal");
+class ContradictionDetector {
+    constructor(llm) {
+        this.llm = llm;
+    }
+    async detect(existingFact, newFact, sourceEntity, targetEntity) {
+        try {
+            const result = await this.llm.chatJson([
+                { role: 'system', content: prompts_1.CONTRADICTION_SYSTEM },
+                {
+                    role: 'user',
+                    content: (0, prompts_1.contradictionUser)(existingFact, newFact, sourceEntity, targetEntity),
+                },
+            ]);
+            if (result.is_contradiction) {
+                return {
+                    isContradiction: true,
+                    explanation: result.explanation,
+                    expiredAt: (0, temporal_1.nowIso)(),
+                };
+            }
+            return { isContradiction: false };
+        }
+        catch (error) {
+            console.warn('Engram: Contradiction detection failed:', error.message);
+            return { isContradiction: false };
+        }
+    }
+}
+exports.ContradictionDetector = ContradictionDetector;
+//# sourceMappingURL=ContradictionDetector.js.map

package/dist/extraction/ContradictionDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContradictionDetector.js","sourceRoot":"","sources":["../../src/extraction/ContradictionDetector.ts"],"names":[],"mappings":";;;AACA,uCAAoE;AACpE,gDAA2C;AAc3C,MAAa,qBAAqB;IAGhC,YAAY,GAAc;QACxB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAMD,KAAK,CAAC,MAAM,CACV,YAAoB,EACpB,OAAe,EACf,YAAoB,EACpB,YAAoB;QAEpB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAsB;gBAC1D,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,8BAAoB,EAAE;gBACjD;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,IAAA,2BAAiB,EAAC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC;iBAC9E;aACF,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBAC5B,OAAO;oBACL,eAAe,EAAE,IAAI;oBACrB,WAAW,EAAE,MAAM,CAAC,WAAW;oBAC/B,SAAS,EAAE,IAAA,iBAAM,GAAE;iBACpB,CAAC;YACJ,CAAC;YAED,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAEf,OAAO,CAAC,IAAI,CAAC,yCAAyC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YAClF,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;CACF;AAzCD,sDAyCC"}

package/dist/extraction/EntityDeduplicator.d.ts

@@ -0,0 +1,17 @@
+import type { LlmClient } from './LlmClient';
+export declare class EntityDeduplicator {
+    private llm;
+    constructor(llm: LlmClient);
+    isDuplicate(newEntity: {
+        name: string;
+        summary: string;
+        entity_type: string;
+    }, existingEntity: {
+        name: string;
+        summary: string;
+        entity_type: string;
+    }): Promise<{
+        isDuplicate: boolean;
+        mergedSummary?: string;
+    }>;
+}

package/dist/extraction/EntityDeduplicator.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityDeduplicator = void 0;
+const prompts_1 = require("./prompts");
+class EntityDeduplicator {
+    constructor(llm) {
+        this.llm = llm;
+    }
+    async isDuplicate(newEntity, existingEntity) {
+        if (newEntity.name.toLowerCase().trim() === existingEntity.name.toLowerCase().trim()) {
+            const mergedSummary = newEntity.summary.length > existingEntity.summary.length
+                ? newEntity.summary
+                : existingEntity.summary;
+            return { isDuplicate: true, mergedSummary };
+        }
+        if (newEntity.entity_type !== existingEntity.entity_type) {
+            return { isDuplicate: false };
+        }
+        try {
+            const result = await this.llm.chatJson([
+                { role: 'system', content: prompts_1.DEDUPLICATION_SYSTEM },
+                {
+                    role: 'user',
+                    content: (0, prompts_1.deduplicationUser)(newEntity, existingEntity),
+                },
+            ]);
+            return {
+                isDuplicate: result.is_duplicate === true,
+                mergedSummary: result.is_duplicate ? result.merged_summary : undefined,
+            };
+        }
+        catch (error) {
+            console.warn('Engram: Entity deduplication failed:', error.message);
+            return { isDuplicate: false };
+        }
+    }
+}
+exports.EntityDeduplicator = EntityDeduplicator;
+//# sourceMappingURL=EntityDeduplicator.js.map

package/dist/extraction/EntityDeduplicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityDeduplicator.js","sourceRoot":"","sources":["../../src/extraction/EntityDeduplicator.ts"],"names":[],"mappings":";;;AACA,uCAAoE;AAOpE,MAAa,kBAAkB;IAG7B,YAAY,GAAc;QACxB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAMD,KAAK,CAAC,WAAW,CACf,SAAiE,EACjE,cAAsE;QAGtE,IAAI,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YAErF,MAAM,aAAa,GACjB,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,MAAM;gBACtD,CAAC,CAAC,SAAS,CAAC,OAAO;gBACnB,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC;YAC7B,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QAC9C,CAAC;QAGD,IAAI,SAAS,CAAC,WAAW,KAAK,cAAc,CAAC,WAAW,EAAE,CAAC;YACzD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QAChC,CAAC;QAGD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAsB;gBAC1D,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,8BAAoB,EAAE;gBACjD;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,IAAA,2BAAiB,EAAC,SAAS,EAAE,cAAc,CAAC;iBACtD;aACF,CAAC,CAAC;YAEH,OAAO;gBACL,WAAW,EAAE,MAAM,CAAC,YAAY,KAAK,IAAI;gBACzC,aAAa,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;aACvE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAEf,OAAO,CAAC,IAAI,CAAC,sCAAsC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YAC/E,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;QAChC,CAAC;IACH,CAAC;CACF;AAlDD,gDAkDC"}

package/dist/extraction/EntityExtractor.d.ts

@@ -0,0 +1,11 @@
+import type { LlmClient } from './LlmClient';
+export interface ExtractedEntity {
+    name: string;
+    entity_type: string;
+    summary: string;
+}
+export declare class EntityExtractor {
+    private llm;
+    constructor(llm: LlmClient);
+    extract(humanMessage: string, aiMessage: string, entityTypes: string[], existingEntities: string[]): Promise<ExtractedEntity[]>;
+}

package/dist/extraction/EntityExtractor.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntityExtractor = void 0;
+const prompts_1 = require("./prompts");
+class EntityExtractor {
+    constructor(llm) {
+        this.llm = llm;
+    }
+    async extract(humanMessage, aiMessage, entityTypes, existingEntities) {
+        try {
+            const result = await this.llm.chatJson([
+                { role: 'system', content: prompts_1.ENTITY_EXTRACTION_SYSTEM },
+                {
+                    role: 'user',
+                    content: (0, prompts_1.entityExtractionUser)(humanMessage, aiMessage, entityTypes, existingEntities),
+                },
+            ]);
+            if (!result.entities || !Array.isArray(result.entities)) {
+                return [];
+            }
+            return result.entities.filter((e) => typeof e.name === 'string' &&
+                e.name.trim() !== '' &&
+                typeof e.entity_type === 'string' &&
+                typeof e.summary === 'string');
+        }
+        catch (error) {
+            console.warn('Engram: Entity extraction failed:', error.message);
+            return [];
+        }
+    }
+}
+exports.EntityExtractor = EntityExtractor;
+//# sourceMappingURL=EntityExtractor.js.map

package/dist/extraction/EntityExtractor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityExtractor.js","sourceRoot":"","sources":["../../src/extraction/EntityExtractor.ts"],"names":[],"mappings":";;;AACA,uCAA2E;AAY3E,MAAa,eAAe;IAG1B,YAAY,GAAc;QACxB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,OAAO,CACX,YAAoB,EACpB,SAAiB,EACjB,WAAqB,EACrB,gBAA0B;QAE1B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAyB;gBAC7D,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kCAAwB,EAAE;gBACrD;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,IAAA,8BAAoB,EAAC,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,gBAAgB,CAAC;iBACtF;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxD,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,EAAE,CACJ,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAC1B,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;gBACpB,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ;gBACjC,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,CAChC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAEf,OAAO,CAAC,IAAI,CAAC,mCAAmC,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;YAC5E,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAvCD,0CAuCC"}

package/dist/extraction/ExtractionPipeline.d.ts

@@ -0,0 +1,24 @@
+import type { IGraphStorage } from '../storage/IGraphStorage';
+import { type LlmClientConfig } from './LlmClient';
+import { type EmbeddingConfig } from '../embeddings';
+export interface ExtractionPipelineConfig {
+    llmConfig: LlmClientConfig;
+    entityTypes: string[];
+    groupId: string;
+    embeddingConfig?: EmbeddingConfig;
+}
+export declare class ExtractionPipeline {
+    private storage;
+    private entityExtractor;
+    private relationshipExtractor;
+    private deduplicator;
+    private contradictionDetector;
+    private embeddingService;
+    private entityTypes;
+    private groupId;
+    constructor(storage: IGraphStorage, config: ExtractionPipelineConfig);
+    process(humanMessage: string, aiMessage: string, episodeUuid?: string): Promise<void>;
+    private resolveEntity;
+    private persistRelationship;
+    private findEntity;
+}

package/dist/extraction/ExtractionPipeline.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExtractionPipeline = void 0;
+const LlmClient_1 = require("./LlmClient");
+const EntityExtractor_1 = require("./EntityExtractor");
+const RelationshipExtractor_1 = require("./RelationshipExtractor");
+const EntityDeduplicator_1 = require("./EntityDeduplicator");
+const ContradictionDetector_1 = require("./ContradictionDetector");
+const embeddings_1 = require("../embeddings");
+const temporal_1 = require("../utils/temporal");
+class ExtractionPipeline {
+    constructor(storage, config) {
+        this.embeddingService = null;
+        const llm = new LlmClient_1.LlmClient(config.llmConfig);
+        this.storage = storage;
+        this.entityExtractor = new EntityExtractor_1.EntityExtractor(llm);
+        this.relationshipExtractor = new RelationshipExtractor_1.RelationshipExtractor(llm);
+        this.deduplicator = new EntityDeduplicator_1.EntityDeduplicator(llm);
+        this.contradictionDetector = new ContradictionDetector_1.ContradictionDetector(llm);
+        this.entityTypes = config.entityTypes;
+        this.groupId = config.groupId;
+        if (config.embeddingConfig) {
+            this.embeddingService = new embeddings_1.EmbeddingService(config.embeddingConfig);
+        }
+    }
+    async process(humanMessage, aiMessage, episodeUuid) {
+        const existingEntities = await this.storage.listEntities(this.groupId);
+        const existingNames = existingEntities.map((e) => e.name);
+        const extractedEntities = await this.entityExtractor.extract(humanMessage, aiMessage, this.entityTypes, existingNames);
+        if (extractedEntities.length === 0)
+            return;
+        const resolvedEntities = new Map();
+        for (const extracted of extractedEntities) {
+            const resolved = await this.resolveEntity(extracted, existingEntities);
+            resolvedEntities.set(extracted.name.toLowerCase(), resolved);
+        }
+        const allEntityNames = [
+            ...new Set([...existingNames, ...[...resolvedEntities.values()].map((e) => e.name)]),
+        ];
+        const extractedRelationships = await this.relationshipExtractor.extract(humanMessage, aiMessage, allEntityNames);
+        for (const rel of extractedRelationships) {
+            await this.persistRelationship(rel, resolvedEntities, existingEntities, episodeUuid);
+        }
+    }
+    async resolveEntity(extracted, existingEntities) {
+        for (const existing of existingEntities) {
+            const { isDuplicate, mergedSummary } = await this.deduplicator.isDuplicate(extracted, {
+                name: existing.name,
+                summary: existing.summary,
+                entity_type: existing.entity_type,
+            });
+            if (isDuplicate) {
+                if (mergedSummary && mergedSummary !== existing.summary) {
+                    return await this.storage.updateEntity(existing.uuid, {
+                        summary: mergedSummary,
+                    });
+                }
+                return existing;
+            }
+        }
+        let nameEmbedding;
+        if (this.embeddingService) {
+            try {
+                const result = await this.embeddingService.embed(extracted.name);
+                nameEmbedding = result.embedding;
+            }
+            catch (error) {
+                console.warn('Engram: Failed to generate entity name embedding:', error.message);
+            }
+        }
+        return await this.storage.addEntity({
+            name: extracted.name,
+            group_id: this.groupId,
+            summary: extracted.summary,
+            entity_type: extracted.entity_type,
+            name_embedding: nameEmbedding !== null && nameEmbedding !== void 0 ? nameEmbedding : null,
+        });
+    }
+    async persistRelationship(rel, resolvedEntities, existingEntities, episodeUuid) {
+        const sourceEntity = this.findEntity(rel.source_entity, resolvedEntities, existingEntities);
+        const targetEntity = this.findEntity(rel.target_entity, resolvedEntities, existingEntities);
+        if (!sourceEntity || !targetEntity)
+            return;
+        const existingEdges = await this.storage.getEdgesBetween(sourceEntity.uuid, targetEntity.uuid);
+        for (const existingEdge of existingEdges) {
+            if (existingEdge.expired_at)
+                continue;
+            const resolution = await this.contradictionDetector.detect(existingEdge.fact, rel.fact, sourceEntity.name, targetEntity.name);
+            if (resolution.isContradiction && resolution.expiredAt) {
+                await this.storage.updateEdge(existingEdge.uuid, {
+                    expired_at: resolution.expiredAt,
+                    invalid_at: resolution.expiredAt,
+                });
+            }
+        }
+        let factEmbedding;
+        if (this.embeddingService) {
+            try {
+                const result = await this.embeddingService.embed(rel.fact);
+                factEmbedding = result.embedding;
+            }
+            catch (error) {
+                console.warn('Engram: Failed to generate edge fact embedding:', error.message);
+            }
+        }
+        await this.storage.addEdge({
+            group_id: this.groupId,
+            source_node_uuid: sourceEntity.uuid,
+            target_node_uuid: targetEntity.uuid,
+            name: rel.name.toUpperCase().replace(/\s+/g, '_'),
+            fact: rel.fact,
+            fact_embedding: factEmbedding !== null && factEmbedding !== void 0 ? factEmbedding : null,
+            valid_at: (0, temporal_1.nowIso)(),
+            episodes: episodeUuid ? [episodeUuid] : [],
+        });
+    }
+    findEntity(name, resolvedEntities, existingEntities) {
+        const normalized = name.toLowerCase().trim();
+        const resolved = resolvedEntities.get(normalized);
+        if (resolved)
+            return resolved;
+        return existingEntities.find((e) => e.name.toLowerCase().trim() === normalized);
+    }
+}
+exports.ExtractionPipeline = ExtractionPipeline;
+//# sourceMappingURL=ExtractionPipeline.js.map

package/dist/extraction/ExtractionPipeline.js.map

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

package/dist/extraction/LlmClient.d.ts

@@ -0,0 +1,36 @@
+export interface LlmClientConfig {
+    apiKey: string;
+    baseUrl: string;
+    model: string;
+    timeoutMs?: number;
+}
+export interface LlmMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface LlmResponse {
+    content: string;
+    usage?: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+export declare class LlmClient {
+    private apiKey;
+    private baseUrl;
+    private model;
+    private timeoutMs;
+    constructor(config: LlmClientConfig);
+    chat(messages: LlmMessage[], options?: {
+        temperature?: number;
+        maxTokens?: number;
+        responseFormat?: {
+            type: 'json_object' | 'text';
+        };
+    }): Promise<LlmResponse>;
+    chatJson<T>(messages: LlmMessage[], options?: {
+        temperature?: number;
+        maxTokens?: number;
+    }): Promise<T>;
+}