@ai.ntellect/core 1.0.0 → 1.1.0

package/dist/modules/nlp/engine.js

@@ -0,0 +1,299 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NLPEngine = void 0;
+const { dockStart } = require("@nlpjs/basic");
+/**
+ * NLP Engine for processing natural language commands
+ * @example
+ * const engine = await NLPEngine.create({
+ *   corpus: require('./corpus.json'),
+ *   responses: require('./responses.json'),
+ *   entities: require('./entities.json')
+ * });
+ *
+ * engine.addAction('transferTokens', async (data) => {
+ *   // Handle transfer logic
+ * });
+ *
+ * const response = await engine.process('transfer 5 ETH');
+ */
+class NLPEngine {
+    constructor() {
+        this.intentHandlers = {};
+        this.responses = {};
+    }
+    /**
+     * Creates and initializes a new NLP Engine
+     */
+    static create(config) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const engine = new NLPEngine();
+            yield engine.init(config);
+            return engine;
+        });
+    }
+    /**
+     * Initializes the NLP engine with configuration
+     */
+    init(_a) {
+        return __awaiter(this, arguments, void 0, function* ({ corpus, responses, entities, language = "en", threshold = 0.5, }) {
+            const dock = yield dockStart({
+                settings: {
+                    nlp: {
+                        forceNER: true,
+                        languages: [language],
+                        corpora: corpus ? [corpus] : undefined,
+                    },
+                    ner: { threshold },
+                },
+                use: ["Basic", "LangEn"],
+            });
+            this.manager = dock.get("nlp");
+            this.responses = responses || {};
+            if (corpus) {
+                yield this.manager.addCorpus(corpus);
+            }
+            if (entities) {
+                this.registerEntities(entities);
+            }
+            yield this.manager.train();
+        });
+    }
+    /**
+     * Registers entities for Named Entity Recognition (NER)
+     * @private
+     * @param {Record<string, any>} entities - Entity definitions
+     */
+    registerEntities(entities) {
+        Object.entries(entities).forEach(([name, data]) => {
+            if (data.options) {
+                Object.entries(data.options).forEach(([option, texts]) => {
+                    this.manager.addNerRuleOptionTexts("en", name, option, texts);
+                });
+            }
+            else if (data.regex) {
+                this.manager.addNerRegexRule("en", name, data.regex);
+            }
+            else if (data.trim) {
+                data.trim.forEach((trimRule) => {
+                    if (trimRule.position === "afterLast") {
+                        trimRule.words.forEach((word) => {
+                            this.manager.addNerAfterLastCondition("en", name, word);
+                        });
+                    }
+                    else if (trimRule.position === "betweenLast") {
+                        this.manager.addNerBetweenLastCondition("en", name, trimRule.leftWords, trimRule.rightWords);
+                    }
+                });
+            }
+        });
+    }
+    /**
+     * Adds an action handler for a specific intent
+     * @param {string} name - Intent name
+     * @param {ActionHandler} handler - Action handler function
+     */
+    addAction(name, handler) {
+        this.intentHandlers[name] = handler;
+    }
+    /**
+     * Creates and loads a pre-trained NLP Engine
+     */
+    static loadFromModel(modelPath, responses) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const engine = new NLPEngine();
+            engine.responses = responses || {};
+            yield engine.loadModel(modelPath);
+            return engine;
+        });
+    }
+    /**
+     * Loads a pre-trained model and configures default actions
+     */
+    loadModel(modelPath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const dock = yield dockStart({
+                settings: {
+                    nlp: {
+                        forceNER: true,
+                        languages: ["en"],
+                    },
+                },
+                use: ["Basic", "LangEn"],
+            });
+            this.manager = dock.get("nlp");
+            yield this.manager.load(modelPath);
+            // Configure default actions handler
+            this.setupDefaultActions();
+        });
+    }
+    /**
+     * Setup default actions to handle responses
+     */
+    setupDefaultActions() {
+        this.manager.onIntent = (data) => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            // Execute registered action if exists
+            if (((_a = data.actions) === null || _a === void 0 ? void 0 : _a.length) > 0) {
+                for (const actionData of data.actions) {
+                    const result = yield this.executeAction(actionData, data);
+                    if (result) {
+                        data.actionResult = result;
+                    }
+                }
+            }
+            // Format response if answer exists
+            if (data.answer && this.responses[data.answer]) {
+                data.jsonResponse = this.formatResponse(this.responses[data.answer], data.actionResult || {});
+            }
+            return data;
+        });
+    }
+    /**
+     * Execute a single action
+     */
+    executeAction(actionData, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { action, parameters } = actionData;
+            const handler = this.manager.actions[action];
+            if (handler) {
+                return handler(context);
+            }
+            return null;
+        });
+    }
+    /**
+     * Processes natural language input text
+     * @param {string} input - Input text to process
+     * @returns {Promise<any>} Processing result with intent, entities and response
+     */
+    process(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.manager.process("en", input);
+            console.log("NLP Engine Result:", result);
+            if (result.intent) {
+                const handler = this.intentHandlers[result.intent.split(".")[1]];
+                if (handler) {
+                    const handlerResult = yield handler(result);
+                    return Object.assign(Object.assign({}, result), handlerResult);
+                }
+            }
+            return result;
+        });
+    }
+    /**
+     * Trains the NLP model with current corpus
+     * @returns {Promise<void>}
+     */
+    train() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.manager.train();
+        });
+    }
+    /**
+     * Exports the trained model
+     * @param {boolean} [minified=true] - Whether to minify the exported model
+     * @returns {string} Exported model as string
+     */
+    export(minified = true) {
+        return this.manager.export(minified);
+    }
+    /**
+     * Imports a previously trained model
+     * @param {string} data - Model data to import
+     */
+    import(data) {
+        this.manager.import(data);
+    }
+    /**
+     * Saves the current model to a file
+     * @param {string} [path='./model.json'] - Path to save the model
+     * @returns {Promise<void>}
+     */
+    saveModel() {
+        return __awaiter(this, arguments, void 0, function* (path = "./model.json") {
+            this.manager.save();
+            this.manager.save("./model.json");
+        });
+    }
+    /**
+     * Formats response using template and context
+     */
+    formatResponse(template, context) {
+        const response = JSON.parse(JSON.stringify(template));
+        // Format data fields
+        if (response.data) {
+            Object.keys(response.data).forEach((key) => {
+                if (context[key] !== undefined) {
+                    response.data[key] = context[key];
+                }
+            });
+        }
+        return response;
+    }
+    /**
+     * Gets entity value from NLP result
+     * @param {any} data - NLP processing result
+     * @param {string} entityName - Name of the entity to extract
+     * @returns {string|undefined} Entity value if found
+     */
+    getEntity(data, entityName) {
+        var _a;
+        const entity = (_a = data.entities) === null || _a === void 0 ? void 0 : _a.find((e) => e.entity === entityName);
+        return entity ? entity.utteranceText : undefined;
+    }
+    /**
+     * Gets entity option from NLP result
+     * @param {any} data - NLP processing result
+     * @param {string} entityName - Name of the entity to extract
+     * @returns {string|undefined} Entity option if found
+     */
+    getEntityOption(data, entityName) {
+        var _a;
+        const entity = (_a = data.entities) === null || _a === void 0 ? void 0 : _a.find((e) => e.entity === entityName);
+        return entity ? entity.option : undefined;
+    }
+    /**
+     * Gets recipient entity from NLP result
+     * @param {any} data - NLP processing result
+     * @returns {string|undefined} Recipient value if found
+     */
+    getRecipient(data) {
+        var _a;
+        const toEntity = (_a = data.entities) === null || _a === void 0 ? void 0 : _a.find((e) => e.entity === "to");
+        return toEntity ? toEntity.utteranceText : undefined;
+    }
+    /**
+     * Gets current responses configuration
+     * @returns {Record<string, any>} Current responses
+     */
+    getResponses() {
+        return this.responses;
+    }
+    /**
+     * Gets current corpus configuration
+     * @returns {any} Current corpus
+     */
+    getCorpus() {
+        return this.manager.corpora;
+    }
+    /**
+     * Gets current entities configuration
+     * @returns {any} Current entities configuration
+     */
+    getEntities() {
+        var _a;
+        return ((_a = this.manager.nerManager) === null || _a === void 0 ? void 0 : _a.rules) || {};
+    }
+}
+exports.NLPEngine = NLPEngine;
+//# sourceMappingURL=engine.js.map

package/dist/modules/nlp/engine.js.map

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

package/dist/modules/nlp/index.d.ts

@@ -0,0 +1,27 @@
+import { NLPNodeConfig } from "@/interfaces";
+import { ZodSchema } from "zod";
+/**
+ * NLPNode class handles natural language processing operations with type-safe schema validation
+ * @template T - Zod schema type for validation
+ */
+export declare class NLPNode<T extends ZodSchema> {
+    private config;
+    private engine;
+    /**
+     * Creates an instance of NLPNode
+     * @param {NLPNodeConfig<T>} config - Configuration object for the NLP node
+     */
+    constructor(config: NLPNodeConfig<T>);
+    /**
+     * Initializes the NLP engine and sets up intent handlers
+     * @returns {Promise<void>}
+     */
+    initialize(): Promise<void>;
+    /**
+     * Processes the input text through the NLP engine
+     * @param {string} input - Text to be processed
+     * @returns {Promise<any>} - Processing result from the engine
+     */
+    process(input: string): Promise<any>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/nlp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../modules/nlp/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGhC;;;GAGG;AACH,qBAAa,OAAO,CAAC,CAAC,SAAS,SAAS;IAO1B,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,MAAM,CAAa;IAE3B;;;OAGG;gBACiB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAE5C;;;OAGG;IACG,UAAU;IAYhB;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM;CAM5B"}

package/dist/modules/nlp/index.js

@@ -0,0 +1,56 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NLPNode = void 0;
+const engine_1 = require("./engine");
+/**
+ * NLPNode class handles natural language processing operations with type-safe schema validation
+ * @template T - Zod schema type for validation
+ */
+class NLPNode {
+    /**
+     * Creates an instance of NLPNode
+     * @param {NLPNodeConfig<T>} config - Configuration object for the NLP node
+     */
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Initializes the NLP engine and sets up intent handlers
+     * @returns {Promise<void>}
+     */
+    initialize() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.engine = yield engine_1.NLPEngine.create(this.config.nlpConfig);
+            console.log("Loaded engine");
+            if (this.config.intentHandlers) {
+                Object.entries(this.config.intentHandlers).forEach(([intent, handler]) => {
+                    this.engine.addAction(intent, handler);
+                });
+            }
+        });
+    }
+    /**
+     * Processes the input text through the NLP engine
+     * @param {string} input - Text to be processed
+     * @returns {Promise<any>} - Processing result from the engine
+     */
+    process(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            console.log("NLP Node processing:", input);
+            const result = yield this.engine.process(input);
+            console.log("NLP Node result:", result);
+            return result;
+        });
+    }
+}
+exports.NLPNode = NLPNode;
+//# sourceMappingURL=index.js.map

package/dist/modules/nlp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../modules/nlp/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AAEA,qCAAqC;AAErC;;;GAGG;AACH,MAAa,OAAO;IAGlB;;;OAGG;IACH,YAAoB,MAAwB;QAAxB,WAAM,GAAN,MAAM,CAAkB;IAAG,CAAC;IAEhD;;;OAGG;IACG,UAAU;;YACd,IAAI,CAAC,MAAM,GAAG,MAAM,kBAAS,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC5D,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;gBAC/B,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,OAAO,CAChD,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE;oBACpB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBACzC,CAAC,CACF,CAAC;YACJ,CAAC;QACH,CAAC;KAAA;IAED;;;;OAIG;IACG,OAAO,CAAC,KAAa;;YACzB,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;YAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAChD,OAAO,CAAC,GAAG,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;YACxC,OAAO,MAAM,CAAC;QAChB,CAAC;KAAA;CACF;AApCD,0BAoCC"}

package/dist/persistence/index.d.ts

@@ -0,0 +1,12 @@
+export { Memory } from "../modules/memory";
+export { InMemoryCheckpointAdapter } from "../execution/adapters/in-memory-checkpoint";
+export { IPetriCheckpointAdapter, InMemoryPetriCheckpointAdapter, } from "../routing/checkpoint-adapter";
+export { RedisPetriCheckpointAdapter } from "../routing/redis-checkpoint-adapter";
+export { PostgresPetriCheckpointAdapter } from "../routing/postgres-checkpoint-adapter";
+export { Neo4jExecutionTracer, } from "./neo4j/execution-tracer";
+export { Neo4jPetriCheckpointAdapter, } from "./neo4j/petri-checkpoint-adapter";
+export { Neo4jMemoryAdapter, } from "./neo4j/memory-adapter";
+export { Neo4jEntityStore, IEntityStore, } from "./neo4j/entity-store";
+export type { Neo4jConfig, Neo4jDriverLike, Neo4jSessionLike, } from "./neo4j/driver";
+export { createDriver } from "./neo4j/driver";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../persistence/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AACvF,OAAO,EACL,uBAAuB,EACvB,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,2BAA2B,EAAE,MAAM,qCAAqC,CAAC;AAClF,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EACL,oBAAoB,GACrB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,gBAAgB,EAChB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/persistence/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDriver = exports.Neo4jEntityStore = exports.Neo4jMemoryAdapter = exports.Neo4jPetriCheckpointAdapter = exports.Neo4jExecutionTracer = exports.PostgresPetriCheckpointAdapter = exports.RedisPetriCheckpointAdapter = exports.InMemoryPetriCheckpointAdapter = exports.InMemoryCheckpointAdapter = exports.Memory = void 0;
+var memory_1 = require("../modules/memory");
+Object.defineProperty(exports, "Memory", { enumerable: true, get: function () { return memory_1.Memory; } });
+var in_memory_checkpoint_1 = require("../execution/adapters/in-memory-checkpoint");
+Object.defineProperty(exports, "InMemoryCheckpointAdapter", { enumerable: true, get: function () { return in_memory_checkpoint_1.InMemoryCheckpointAdapter; } });
+var checkpoint_adapter_1 = require("../routing/checkpoint-adapter");
+Object.defineProperty(exports, "InMemoryPetriCheckpointAdapter", { enumerable: true, get: function () { return checkpoint_adapter_1.InMemoryPetriCheckpointAdapter; } });
+var redis_checkpoint_adapter_1 = require("../routing/redis-checkpoint-adapter");
+Object.defineProperty(exports, "RedisPetriCheckpointAdapter", { enumerable: true, get: function () { return redis_checkpoint_adapter_1.RedisPetriCheckpointAdapter; } });
+var postgres_checkpoint_adapter_1 = require("../routing/postgres-checkpoint-adapter");
+Object.defineProperty(exports, "PostgresPetriCheckpointAdapter", { enumerable: true, get: function () { return postgres_checkpoint_adapter_1.PostgresPetriCheckpointAdapter; } });
+var execution_tracer_1 = require("./neo4j/execution-tracer");
+Object.defineProperty(exports, "Neo4jExecutionTracer", { enumerable: true, get: function () { return execution_tracer_1.Neo4jExecutionTracer; } });
+var petri_checkpoint_adapter_1 = require("./neo4j/petri-checkpoint-adapter");
+Object.defineProperty(exports, "Neo4jPetriCheckpointAdapter", { enumerable: true, get: function () { return petri_checkpoint_adapter_1.Neo4jPetriCheckpointAdapter; } });
+var memory_adapter_1 = require("./neo4j/memory-adapter");
+Object.defineProperty(exports, "Neo4jMemoryAdapter", { enumerable: true, get: function () { return memory_adapter_1.Neo4jMemoryAdapter; } });
+var entity_store_1 = require("./neo4j/entity-store");
+Object.defineProperty(exports, "Neo4jEntityStore", { enumerable: true, get: function () { return entity_store_1.Neo4jEntityStore; } });
+var driver_1 = require("./neo4j/driver");
+Object.defineProperty(exports, "createDriver", { enumerable: true, get: function () { return driver_1.createDriver; } });
+//# sourceMappingURL=index.js.map

package/dist/persistence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../persistence/index.ts"],"names":[],"mappings":";;;AAAA,4CAA2C;AAAlC,gGAAA,MAAM,OAAA;AACf,mFAAuF;AAA9E,iIAAA,yBAAyB,OAAA;AAClC,oEAGuC;AADrC,oIAAA,8BAA8B,OAAA;AAEhC,gFAAkF;AAAzE,uIAAA,2BAA2B,OAAA;AACpC,sFAAwF;AAA/E,6IAAA,8BAA8B,OAAA;AACvC,6DAEkC;AADhC,wHAAA,oBAAoB,OAAA;AAEtB,6EAE0C;AADxC,uIAAA,2BAA2B,OAAA;AAE7B,yDAEgC;AAD9B,oHAAA,kBAAkB,OAAA;AAEpB,qDAG8B;AAF5B,gHAAA,gBAAgB,OAAA;AAQlB,yCAA8C;AAArC,sGAAA,YAAY,OAAA"}

package/dist/persistence/neo4j/driver.d.ts

@@ -0,0 +1,26 @@
+export interface Neo4jSessionLike {
+    run(query: string, params?: Record<string, any>): Promise<{
+        records: any[];
+    }>;
+    close(): Promise<void>;
+}
+export interface Neo4jDriverLike {
+    session(config?: {
+        database?: string;
+    }): Neo4jSessionLike;
+    close(): Promise<void>;
+}
+export type Neo4jConfig = {
+    driver: Neo4jDriverLike;
+    database?: string;
+} | {
+    url: string;
+    username: string;
+    password: string;
+    database?: string;
+};
+export declare function createDriver(config: Neo4jConfig): Promise<{
+    driver: Neo4jDriverLike;
+    database?: string;
+}>;
+//# sourceMappingURL=driver.d.ts.map

package/dist/persistence/neo4j/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../../persistence/neo4j/driver.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC,CAAC;IAC9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,gBAAgB,CAAC;IAC1D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,wBAAsB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB/G"}

package/dist/persistence/neo4j/driver.js

@@ -0,0 +1,64 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDriver = createDriver;
+function createDriver(config) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if ("driver" in config) {
+            return { driver: config.driver, database: config.database };
+        }
+        let neo4j;
+        try {
+            neo4j = yield Promise.resolve().then(() => __importStar(require("neo4j-driver")));
+        }
+        catch (_a) {
+            throw new Error("neo4j-driver is not installed. Install it with: npm install neo4j-driver");
+        }
+        const driver = neo4j.default.auth
+            ? neo4j.default.driver(config.url, neo4j.default.auth.basic(config.username, config.password))
+            : neo4j.default.driver(config.url, neo4j.default.auth.basic(config.username, config.password));
+        return { driver, database: config.database };
+    });
+}
+//# sourceMappingURL=driver.js.map

package/dist/persistence/neo4j/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../../../persistence/neo4j/driver.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAcA,oCAmBC;AAnBD,SAAsB,YAAY,CAAC,MAAmB;;QACpD,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YACvB,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC9D,CAAC;QAED,IAAI,KAAU,CAAC;QACf,IAAI,CAAC;YACH,KAAK,GAAG,wDAAa,cAAc,GAAC,CAAC;QACvC,CAAC;QAAC,WAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,0EAA0E,CAC3E,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI;YAC/B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC9F,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAEjG,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC/C,CAAC;CAAA"}

package/dist/persistence/neo4j/entity-store.d.ts

@@ -0,0 +1,15 @@
+import { Entity } from "../../agent/entity-resolver/types";
+import { IEntityStore } from "../../agent/entity-resolver/entity-index";
+import { Neo4jDriverLike } from "./driver";
+export { IEntityStore };
+export declare class Neo4jEntityStore implements IEntityStore {
+    private driver;
+    private database?;
+    constructor(driver: Neo4jDriverLike, database?: string | undefined);
+    private session;
+    upsertMany(entities: Entity[]): Promise<void>;
+    loadAll(scope?: string): Promise<Entity[]>;
+    recordResolution(entityId: string, query: string, confidence: number): Promise<void>;
+    clear(scope?: string): Promise<void>;
+}
+//# sourceMappingURL=entity-store.d.ts.map

package/dist/persistence/neo4j/entity-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-store.d.ts","sourceRoot":"","sources":["../../../persistence/neo4j/entity-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mCAAmC,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AACxE,OAAO,EAAE,eAAe,EAAoB,MAAM,UAAU,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB,qBAAa,gBAAiB,YAAW,YAAY;IAEjD,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ,CAAC;gBADT,MAAM,EAAE,eAAe,EACvB,QAAQ,CAAC,EAAE,MAAM,YAAA;IAG3B,OAAO,CAAC,OAAO;IAIT,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAyC7C,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwC1C,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC;IAoBV,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB3C"}