@carlonicora/nestjs-neo4jsonapi 0.0.1

package/dist/agents/contextualiser/services/contextualiser.service.js

@@ -0,0 +1,193 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextualiserService = void 0;
+const langgraph_1 = require("@langchain/langgraph");
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const nestjs_cls_1 = require("nestjs-cls");
+const contextualiser_context_1 = require("../../contextualiser/contexts/contextualiser.context");
+const contextualiser_context_factory_1 = require("../../contextualiser/factories/contextualiser.context.factory");
+const atomicfacts_node_service_1 = require("../../contextualiser/nodes/atomicfacts.node.service");
+const chunk_node_service_1 = require("../../contextualiser/nodes/chunk.node.service");
+const keyconcepts_node_service_1 = require("../../contextualiser/nodes/keyconcepts.node.service");
+const question_refiner_node_service_1 = require("../../contextualiser/nodes/question.refiner.node.service");
+const rational_node_service_1 = require("../../contextualiser/nodes/rational.node.service");
+const tracing_service_1 = require("../../../core/tracing/services/tracing.service");
+let ContextualiserService = class ContextualiserService {
+    constructor(contextualiserContextFactoryService, questionRefinedNode, rationalNode, keyConceptsNode, atomicFactsNode, chunkNode, clsService, tracer) {
+        this.contextualiserContextFactoryService = contextualiserContextFactoryService;
+        this.questionRefinedNode = questionRefinedNode;
+        this.rationalNode = rationalNode;
+        this.keyConceptsNode = keyConceptsNode;
+        this.atomicFactsNode = atomicFactsNode;
+        this.chunkNode = chunkNode;
+        this.clsService = clsService;
+        this.tracer = tracer;
+    }
+    async run(params) {
+        const maxHops = 20;
+        const mainPrompt = undefined;
+        const finalPrompt = undefined;
+        const initial = params.messages.length === 0 ? "question_refiner" : "rational_plan";
+        this.tracer.startSpan("Contextualiser Workflow", {
+            attributes: {
+                companyId: params.companyId,
+                contentId: params.contentId,
+                contentType: params.contentType,
+                messagesCount: params.messages.length,
+                question: params.question ?? "none",
+                maxHops: maxHops,
+                recursionLimit: maxHops + 2,
+                initialNode: initial,
+            },
+        });
+        const returnState = (params) => {
+            if (params.state.status.length) {
+                this.clsService.set("ragStatus", `${params.state.status.join("\n\n")}`);
+            }
+            const nextStep = params.forceNextStep ?? params.state.nextStep;
+            const finalNextStep = params.state.hops === maxHops ? "answer" : nextStep;
+            return finalNextStep;
+        };
+        const workflow = new langgraph_1.StateGraph(contextualiser_context_1.ContextualiserContext)
+            .addNode("question_refiner", async (state) => {
+            this.tracer.addSpanEvent(`Node: question_refiner - hop ${state.hops}/${maxHops}`, {
+                hopCount: state.hops,
+            });
+            const result = await this.questionRefinedNode.execute({ state: state });
+            this.tracer.addSpanEvent(`Node: question_refiner complete - hop ${state.hops}/${maxHops}`, {
+                nextStep: result.nextStep,
+            });
+            return result;
+        })
+            .addNode("rational_plan", async (state) => {
+            this.tracer.addSpanEvent(`Node: rational_plan - hop ${state.hops}/${maxHops}`, {
+                hopCount: state.hops,
+            });
+            const result = await this.rationalNode.execute({ state: state });
+            this.tracer.addSpanEvent(`Node: rational_plan complete - hop ${state.hops}/${maxHops}`, {
+                nextStep: result.nextStep,
+            });
+            return result;
+        })
+            .addNode("key_concepts", async (state) => {
+            this.tracer.addSpanEvent(`Node: key_concepts - hop ${state.hops}/${maxHops}`, {
+                hopCount: state.hops,
+            });
+            const result = await this.keyConceptsNode.execute({
+                state: state,
+            });
+            this.tracer.addSpanEvent(`Node: key_concepts complete - hop ${state.hops}/${maxHops}`, {
+                nextStep: result.nextStep,
+            });
+            return result;
+        })
+            .addNode("atomic_facts", async (state) => {
+            this.tracer.addSpanEvent(`Node: atomic_facts - hop ${state.hops}/${maxHops}`, {
+                hopCount: state.hops,
+            });
+            const result = await this.atomicFactsNode.execute({
+                state: state,
+            });
+            this.tracer.addSpanEvent(`Node: atomic_facts complete - hop ${state.hops}/${maxHops}`, {
+                nextStep: result.nextStep,
+            });
+            return result;
+        })
+            .addNode("chunks", async (state) => {
+            this.tracer.addSpanEvent(`Node: chunks - hop ${state.hops}/${maxHops}`, {
+                hopCount: state.hops,
+            });
+            const result = await this.chunkNode.execute({
+                state: state,
+            });
+            this.tracer.addSpanEvent(`Node: chunks complete - hop ${state.hops}/${maxHops}`, {
+                nextStep: result.nextStep,
+            });
+            return result;
+        })
+            .addNode("neighbouring_nodes", async (state) => {
+            this.tracer.addSpanEvent(`Node: neighbouring_nodes - hop ${state.hops}/${maxHops}`, {
+                hopCount: state.hops,
+            });
+            const result = await this.keyConceptsNode.execute({
+                state: state,
+            });
+            this.tracer.addSpanEvent(`Node: neighbouring_nodes complete - hop ${state.hops}/${maxHops}`, {
+                nextStep: result.nextStep,
+            });
+            return result;
+        })
+            .addNode("answer", (state) => {
+            this.tracer.addSpanEvent(`Node: answer - hop ${state.hops}/${maxHops} (final)`, {
+                hopCount: state.hops,
+            });
+            return { ...state, tokens: { input: 0, output: 0 } };
+        })
+            .addEdge(langgraph_1.START, initial)
+            .addEdge("question_refiner", "rational_plan")
+            .addConditionalEdges("rational_plan", (state) => returnState({ state }))
+            .addConditionalEdges("key_concepts", (state) => returnState({ state: state, forceNextStep: "atomic_facts" }))
+            .addConditionalEdges("atomic_facts", (state) => returnState({ state }))
+            .addConditionalEdges("neighbouring_nodes", (state) => returnState({ state: state, forceNextStep: "atomic_facts" }))
+            .addConditionalEdges("chunks", (state) => returnState({ state }))
+            .addEdge("answer", langgraph_1.END);
+        const threadId = (0, crypto_1.randomUUID)();
+        const checkpointer = new langgraph_1.MemorySaver();
+        const app = workflow.compile({ checkpointer: checkpointer });
+        const initialState = this.contextualiserContextFactoryService.create({
+            companyId: params.companyId,
+            contentId: params.contentId,
+            contentType: params.contentType,
+            dataLimits: params.dataLimits,
+            question: params.question,
+            mainPrompt: mainPrompt,
+            finalPrompt: finalPrompt,
+            previousMessages: params.messages,
+            preselectedChunks: [],
+        });
+        this.tracer.addSpanEvent("Workflow Executing");
+        const stepCount = 0;
+        let finalState;
+        try {
+            finalState = await app.invoke(initialState, {
+                configurable: { thread_id: threadId },
+                recursionLimit: maxHops + 2,
+            });
+            this.tracer.addSpanEvent("Workflow Completed", {
+                finalHopCount: finalState.hops,
+                totalSteps: stepCount,
+            });
+            this.tracer.setSpanSuccess();
+            this.tracer.endSpan();
+        }
+        catch (e) {
+            this.tracer.setSpanError(e);
+            this.tracer.endSpan();
+            throw e;
+        }
+        return finalState;
+    }
+};
+exports.ContextualiserService = ContextualiserService;
+exports.ContextualiserService = ContextualiserService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [contextualiser_context_factory_1.ContextualiserContextFactoryService,
+        question_refiner_node_service_1.QuestionRefinerNodeService,
+        rational_node_service_1.RationalNodeService,
+        keyconcepts_node_service_1.KeyConceptsNodeService,
+        atomicfacts_node_service_1.AtomicFactsNodeService,
+        chunk_node_service_1.ChunkNodeService,
+        nestjs_cls_1.ClsService,
+        tracing_service_1.TracingService])
+], ContextualiserService);
+//# sourceMappingURL=contextualiser.service.js.map

package/dist/agents/contextualiser/services/contextualiser.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextualiser.service.js","sourceRoot":"","sources":["../../../../src/agents/contextualiser/services/contextualiser.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,oDAA2E;AAC3E,2CAA4C;AAC5C,mCAAoC;AACpC,2CAAwC;AACxC,iGAG8D;AAC9D,kHAAoH;AACpH,kGAA6F;AAC7F,sFAAiF;AACjF,kGAA6F;AAC7F,4GAAsG;AACtG,4FAAuF;AAGvF,oFAAgF;AAGzE,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YACmB,mCAAwE,EACxE,mBAA+C,EAC/C,YAAiC,EACjC,eAAuC,EACvC,eAAuC,EACvC,SAA2B,EAC3B,UAAsB,EACtB,MAAsB;QAPtB,wCAAmC,GAAnC,mCAAmC,CAAqC;QACxE,wBAAmB,GAAnB,mBAAmB,CAA4B;QAC/C,iBAAY,GAAZ,YAAY,CAAqB;QACjC,oBAAe,GAAf,eAAe,CAAwB;QACvC,oBAAe,GAAf,eAAe,CAAwB;QACvC,cAAS,GAAT,SAAS,CAAkB;QAC3B,eAAU,GAAV,UAAU,CAAY;QACtB,WAAM,GAAN,MAAM,CAAgB;IACtC,CAAC;IAEJ,KAAK,CAAC,GAAG,CAAC,MAQT;QACC,MAAM,OAAO,GAAG,EAAE,CAAC;QAEnB,MAAM,UAAU,GAAuB,SAAS,CAAC;QACjD,MAAM,WAAW,GAAuB,SAAS,CAAC;QAElD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,eAAe,CAAC;QAEpF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,yBAAyB,EAAE;YAC/C,UAAU,EAAE;gBACV,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;gBACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM;gBACnC,OAAO,EAAE,OAAO;gBAChB,cAAc,EAAE,OAAO,GAAG,CAAC;gBAC3B,WAAW,EAAE,OAAO;aACrB;SACF,CAAC,CAAC;QAEH,MAAM,WAAW,GAAG,CAAC,MAAqE,EAAU,EAAE;YACpG,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC/B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1E,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC;YAC/D,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;YAE1E,OAAO,aAAa,CAAC;QACvB,CAAC,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,sBAAU,CAAC,8CAAqB,CAAC;aACnD,OAAO,CAAC,kBAAkB,EAAE,KAAK,EAAE,KAAiC,EAAE,EAAE;YACvE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,gCAAgC,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBAChF,QAAQ,EAAE,KAAK,CAAC,IAAI;aACrB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,yCAAyC,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBACzF,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;aACD,OAAO,CAAC,eAAe,EAAE,KAAK,EAAE,KAAiC,EAAE,EAAE;YACpE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,6BAA6B,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBAC7E,QAAQ,EAAE,KAAK,CAAC,IAAI;aACrB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,sCAAsC,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBACtF,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;aACD,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,KAAiC,EAAE,EAAE;YACnE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,4BAA4B,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBAC5E,QAAQ,EAAE,KAAK,CAAC,IAAI;aACrB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;gBAChD,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,qCAAqC,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBACrF,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;aACD,OAAO,CAAC,cAAc,EAAE,KAAK,EAAE,KAAiC,EAAE,EAAE;YACnE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,4BAA4B,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBAC5E,QAAQ,EAAE,KAAK,CAAC,IAAI;aACrB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;gBAChD,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,qCAAqC,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBACrF,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;aACD,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAiC,EAAE,EAAE;YAC7D,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,sBAAsB,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBACtE,QAAQ,EAAE,KAAK,CAAC,IAAI;aACrB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;gBAC1C,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,+BAA+B,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBAC/E,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;aACD,OAAO,CAAC,oBAAoB,EAAE,KAAK,EAAE,KAAiC,EAAE,EAAE;YACzE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,kCAAkC,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBAClF,QAAQ,EAAE,KAAK,CAAC,IAAI;aACrB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;gBAChD,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,2CAA2C,KAAK,CAAC,IAAI,IAAI,OAAO,EAAE,EAAE;gBAC3F,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B,CAAC,CAAC;YACH,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;aACD,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAiC,EAAE,EAAE;YACvD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,sBAAsB,KAAK,CAAC,IAAI,IAAI,OAAO,UAAU,EAAE;gBAC9E,QAAQ,EAAE,KAAK,CAAC,IAAI;aACrB,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvD,CAAC,CAAC;aACD,OAAO,CAAC,iBAAK,EAAE,OAAO,CAAC;aACvB,OAAO,CAAC,kBAAkB,EAAE,eAAe,CAAC;aAC5C,mBAAmB,CAAC,eAAe,EAAE,CAAC,KAAiC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;aACnG,mBAAmB,CAAC,cAAc,EAAE,CAAC,KAAiC,EAAE,EAAE,CACzE,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAC7D;aACA,mBAAmB,CAAC,cAAc,EAAE,CAAC,KAAiC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;aAClG,mBAAmB,CAAC,oBAAoB,EAAE,CAAC,KAAiC,EAAE,EAAE,CAC/E,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,CAAC,CAC7D;aACA,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAiC,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;aAC5F,OAAO,CAAC,QAAQ,EAAE,eAAG,CAAC,CAAC;QAE1B,MAAM,QAAQ,GAAG,IAAA,mBAAU,GAAE,CAAC;QAC9B,MAAM,YAAY,GAAG,IAAI,uBAAW,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC;QAE7D,MAAM,YAAY,GAA+B,IAAI,CAAC,mCAAmC,CAAC,MAAM,CAAC;YAC/F,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,UAAU;YACtB,WAAW,EAAE,WAAW;YACxB,gBAAgB,EAAE,MAAM,CAAC,QAAQ;YACjC,iBAAiB,EAAE,EAAE;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,oBAAoB,CAAC,CAAC;QAE/C,MAAM,SAAS,GAAG,CAAC,CAAC;QACpB,IAAI,UAAsC,CAAC;QAE3C,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,YAAY,EAAE;gBAC1C,YAAY,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE;gBACrC,cAAc,EAAE,OAAO,GAAG,CAAC;aACrB,CAAC,CAAC;YAEV,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE;gBAC7C,aAAa,EAAE,UAAU,CAAC,IAAI;gBAC9B,UAAU,EAAE,SAAS;aACtB,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACxB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAU,CAAC,CAAC;YACrC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,CAAC,CAAC;QACV,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;CACF,CAAA;AArLY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;qCAG6C,oEAAmC;QACnD,0DAA0B;QACjC,2CAAmB;QAChB,iDAAsB;QACtB,iDAAsB;QAC5B,qCAAgB;QACf,uBAAU;QACd,gCAAc;GAT9B,qBAAqB,CAqLjC"}

package/dist/agents/graph.creator/graph.creator.module.d.ts

@@ -0,0 +1,3 @@
+export declare class GraphCreatorModule {
+}
+//# sourceMappingURL=graph.creator.module.d.ts.map

package/dist/agents/graph.creator/graph.creator.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.creator.module.d.ts","sourceRoot":"","sources":["../../../src/agents/graph.creator/graph.creator.module.ts"],"names":[],"mappings":"AAKA,qBAKa,kBAAkB;CAAG"}

package/dist/agents/graph.creator/graph.creator.module.js

@@ -0,0 +1,24 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GraphCreatorModule = void 0;
+const common_1 = require("@nestjs/common");
+const graph_creator_service_1 = require("./services/graph.creator.service");
+const llm_module_1 = require("../../core/llm/llm.module");
+const logging_module_1 = require("../../core/logging/logging.module");
+let GraphCreatorModule = class GraphCreatorModule {
+};
+exports.GraphCreatorModule = GraphCreatorModule;
+exports.GraphCreatorModule = GraphCreatorModule = __decorate([
+    (0, common_1.Module)({
+        imports: [llm_module_1.LLMModule, logging_module_1.LoggingModule],
+        providers: [graph_creator_service_1.GraphCreatorService],
+        exports: [graph_creator_service_1.GraphCreatorService],
+    })
+], GraphCreatorModule);
+//# sourceMappingURL=graph.creator.module.js.map

package/dist/agents/graph.creator/graph.creator.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.creator.module.js","sourceRoot":"","sources":["../../../src/agents/graph.creator/graph.creator.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,4EAAuE;AACvE,0DAAsD;AACtD,sEAAkE;AAO3D,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;CAAG,CAAA;AAArB,gDAAkB;6BAAlB,kBAAkB;IAL9B,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,sBAAS,EAAE,8BAAa,CAAC;QACnC,SAAS,EAAE,CAAC,2CAAmB,CAAC;QAChC,OAAO,EAAE,CAAC,2CAAmB,CAAC;KAC/B,CAAC;GACW,kBAAkB,CAAG"}

package/dist/agents/graph.creator/interfaces/chunk.analysis.interface.d.ts

@@ -0,0 +1,14 @@
+import { TokenUsageInterface } from "../../../common/interfaces/token.usage.interface";
+export interface ChunkAnalysisInterface {
+    atomicFacts: {
+        content: string;
+        keyConcepts: string[];
+    }[];
+    keyConceptsRelationships: {
+        keyConcept1: string;
+        keyConcept2: string;
+        relationship: string;
+    }[];
+    tokens: TokenUsageInterface;
+}
+//# sourceMappingURL=chunk.analysis.interface.d.ts.map

package/dist/agents/graph.creator/interfaces/chunk.analysis.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.analysis.interface.d.ts","sourceRoot":"","sources":["../../../../src/agents/graph.creator/interfaces/chunk.analysis.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAEvF,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,EAAE,CAAC;KACvB,EAAE,CAAC;IACJ,wBAAwB,EAAE;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;KACtB,EAAE,CAAC;IACJ,MAAM,EAAE,mBAAmB,CAAC;CAC7B"}

package/dist/agents/graph.creator/interfaces/chunk.analysis.interface.js

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

package/dist/agents/graph.creator/interfaces/chunk.analysis.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.analysis.interface.js","sourceRoot":"","sources":["../../../../src/agents/graph.creator/interfaces/chunk.analysis.interface.ts"],"names":[],"mappings":""}

package/dist/agents/graph.creator/services/graph.creator.service.d.ts

@@ -0,0 +1,17 @@
+import { ConfigService } from "@nestjs/config";
+import { BaseConfigInterface } from "../../../config/interfaces";
+import { LLMService } from "../../../core/llm/services/llm.service";
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { ChunkAnalysisInterface } from "../../graph.creator/interfaces/chunk.analysis.interface";
+export declare const prompt = "\nYou are an intelligent assistant that extracts structured knowledge from text.\n\n## CRITICAL: Garbage Detection\n\n**BEFORE attempting any extraction, evaluate if the text is intelligible.**\n\nIf the text contains:\n- Unintelligible OCR garbage or random characters (e.g., \"!\u00A7Ydsv$\", \"aitsru{.*U\", \"Q\u00A7tvllvll\")\n- Mostly punctuation marks with no semantic meaning (e.g., \"!!!\", \"===\", \"|||\")\n- Random character sequences that form no recognizable words\n- Repetitive meaningless patterns\n- No coherent sentences or semantic content\n\n**Then you MUST:**\n- Return EMPTY atomicFacts array: []\n- Return EMPTY keyConceptsRelationships array: []\n- Do NOT attempt to extract anything from garbage text\n\n## Definitions\n\n**Atomic Fact**: A single, indivisible statement containing **ONE action, ONE event, or ONE relationship**. Each atomic fact must represent the smallest unit of meaningful information that cannot be broken down further.\n\n**CRITICAL: ONE ACTION PER FACT**\n- Each atomic fact must contain ONLY ONE verb/action\n- If a sentence contains multiple actions connected by \"and\", \"but\", commas, split it into separate atomic facts\n- Each action, decision, or event gets its own atomic fact\n\n**Examples of CORRECT Atomic Facts (one action each):**\n- \u2705 \"The president detects the ambiguity of the notification\"\n- \u2705 \"The president grants an extension until 15/2/2023\"\n- \u2705 \"The president postpones the hearing to 29/3/2023\"\n- \u2705 \"Joe Bauer was born in London on 03.04.1985\"\n\n**Examples of INCORRECT Atomic Facts (multiple actions - MUST BE SPLIT):**\n- \u274C \"The president detects the ambiguity of the notification, grants an extension until 15/2/2023 and postpones the hearing to 29/3/2023\"\n  \u2192 WRONG: Contains 3 actions (detects, grants, postpones) - must be split into 3 atomic facts\n- \u274C \"Joe Bauer was born in London and studied at university\"\n  \u2192 WRONG: Contains 2 actions (was born, studied) - must be split into 2 atomic facts\n\n**Key Concept**: ONLY semantically meaningful entities - proper nouns, specific terms, named entities:\n\n**VALID Key Concepts (extract these):**\n- **Proper names**: \"joe bauer\", \"mike modano\", ...\n- **Places**: \"london\", \"italy\", \"rome\", \"washington\", ...\n- **Organizations**: \"microsoft\", \"apple\", \"phlow\", \"united nations\", \"tribunale di roma\", ...\n- **Complete dates with legal significance**: \"28.12.2019\", \"15/2/2023\", \"29/3/2023\", \"03.04.1985\", \"15 january 2023\"\n  - \u2705 ONLY extract dates that are significant to the atomic fact\n  - \u2705 Include time ONLY when paired with a date AND relevant to the atomic fact: \"29/3/2023 alle 10.40\"\n- **Acronyms**: \"upu\", \"nlp\", \"api\", \"crm\", \"d.p.r.\", \"c.c.\", \"c.p.\" (always lowercase)\n- **Technical terms**: \"knowledge base\", \"semantic search\", \"blockchain\"\n- **Products/systems**: \"kubernetes\", \"microsoft\", \"s3\"\n\n**INVALID Key Concepts (NEVER extract these):**\n- \u274C Single characters: \"!\", \"e\", \"i\", \"a\", \"o\", \"n\", \"'\"\n- \u274C Pure punctuation: \".\", \",\", \":\", \";\", \"(\", \")\", \"[\", \"]\"\n- \u274C Random garbage: \"!\u00A7Ydsv$\", \"Q\u00A7tvllvll\", \"aitsru{.*U\", \"ourpEl}r\"\n- \u274C Meaningless sequences: \"||!\", \"===\", \"___\", \"***\"\n- \u274C Pure numbers without context: \"254\", \"819\", \"123\"\n- \u274C **Isolated times without dates**: \"12.40\", \"10:30\", \"15.00\" (unless part of legally significant event like \"udienza alle 10.40\" with date)\n- \u274C **Administrative timestamps**: \"verbale chiuso alle 12.40\", \"documento firmato alle 15.00\" (not legally significant)\n- \u274C Generic words without specific meaning: \"thing\", \"way\", \"type\", \"method\"\n\n**Markdown Headers**: Structural elements like \"## Data Architecture\" that organize content.\n\n## Instructions\n\n1. **Evaluate text quality** - Is this intelligible text or garbage? If garbage, return empty arrays.\n2. **Check for markdown headers** - If text starts with ##, ###, etc., note the complete header text\n3. **Decompose compound sentences** - If a sentence contains multiple actions/verbs (connected by \"and\", \"but\", commas):\n   - Break it into separate atomic facts\n   - Each action gets its own atomic fact\n   - Example: \"The president detects the ambiguity, grants an extension and postpones the hearing\" \u2192 3 atomic facts\n4. **Extract atomic facts** - Only from intelligible, meaningful text. ONE ACTION PER FACT.\n5. **MANDATORY: Create summary atomic fact** - Must include the markdown header if present. Example: \"Recommendation 1 focuses on improving UPU service standards\" (key concepts: \"recommendation 1\", \"upu\", \"service standards\")\n6. **Identify key concepts** - Only SEMANTICALLY MEANINGFUL entities (names, places, significant dates, organizations, legal terms)\n7. **Create relationships** - Between valid key concepts based on how they connect in atomic facts\n\n## Atomic Fact Rules\n\n**CRITICAL: ONE ACTION/EVENT PER ATOMIC FACT**\n- Each atomic fact must contain ONLY ONE verb/action\n- If you see multiple verbs in a sentence (e.g., \"detects\", \"grants\", \"postpones\"), create separate atomic facts for each\n- Use the subject from the original sentence for each split fact\n- Each atomic fact must be a complete, grammatically correct sentence\n\n**Decomposition Process:**\n1. Identify all verbs/actions in the sentence\n2. Count them - if more than one, decomposition is required\n3. Create one atomic fact per action, maintaining the subject\n4. Example:\n   - Input: \"The president detects the ambiguity, grants an extension and postpones the hearing\"\n   - Actions found: \"detects\" (1), \"grants\" (2), \"postpones\" (3) = 3 actions\n   - Output: 3 atomic facts:\n     1. \"The president detects the ambiguity\"\n     2. \"The president grants an extension\"\n     3. \"The president postpones the hearing\"\n\n## Key Concept Rules\n\n- Key concepts **MUST** be semantically meaningful entities (see examples above)\n- **COPY VERBATIM** from the text (lowercasing allowed, no other changes)\n- Minimum 2 characters length\n- Must contain actual semantic meaning (not punctuation, not single letters)\n- **DO NOT change** spelling, letters, or structure\n- Always include acronyms and technical terms found in text\n- Include complete markdown headers as Key Concepts: \"## Recommendation 1\" becomes \"recommendation 1\"\n- Every key concept must appear in at least one atomic fact\n\n**Character Requirements:**\n- Must have at least 40% alphanumeric characters (not mostly punctuation)\n- Cannot be pure punctuation or special characters\n- Cannot be random character sequences\n\n## Relationships Rules\n\n**Key Concepts Relationships**: Analyze relationships between key concepts to create a network graph.\n- For each relationship:\n  - **node_1**: First key concept (must be a valid key concept from extraction)\n  - **node_2**: Second key concept (must be a valid key concept from extraction)\n  - **edge**: Sentence describing the relationship in present tense\n- Only create relationships between VALID key concepts\n- Both nodes must be semantically meaningful entities\n\n## Additional Considerations\n\n- **DECOMPOSE compound sentences** - Always split sentences with multiple actions into separate atomic facts\n- Focus on extracting **named entities** and **specific domain terminology**\n- Ignore filler words, articles, prepositions, conjunctions\n- Pay special attention to proper names, places, significant dates, organizations, and legal entities\n- Terms mentioned in the same sentence or paragraph are typically related\n\n## CRITICAL: Quality over Quantity\n\n- It is BETTER to return empty arrays than to extract garbage\n- Only extract from intelligible, meaningful text\n- Every key concept must be a real entity with semantic meaning\n- Single characters, punctuation, and random sequences are NEVER valid key concepts\n\n## CRITICAL: Atomic Fact Decomposition\n\n**MANDATORY PROCESS FOR EVERY SENTENCE:**\n1. Count the number of actions/verbs in the sentence\n2. If count > 1, YOU MUST split into separate atomic facts\n3. Each action gets its own atomic fact with complete subject and context\n4. NEVER create compound atomic facts with multiple actions\n\n**Remember:**\n- \u274C WRONG: \"The president detects, grants and postpones\" (3 actions in 1 fact)\n- \u2705 RIGHT: Three separate facts - one for \"detects\", one for \"grants\", one for \"postpones\"\n\n## **Strictly follow the above instructions. Evaluate text quality first, then decompose compound sentences. Begin.**\n";
+export declare class GraphCreatorService {
+    private readonly llmService;
+    private readonly logger;
+    private readonly configService;
+    private readonly systemPrompt;
+    constructor(llmService: LLMService, logger: AppLoggingService, configService: ConfigService<BaseConfigInterface>);
+    generateGraph(params: {
+        content: string;
+    }): Promise<ChunkAnalysisInterface>;
+}
+//# sourceMappingURL=graph.creator.service.d.ts.map

package/dist/agents/graph.creator/services/graph.creator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.creator.service.d.ts","sourceRoot":"","sources":["../../../../src/agents/graph.creator/services/graph.creator.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,mBAAmB,EAA0B,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yDAAyD,CAAC;AAEjG,eAAO,MAAM,MAAM,8+QAwJlB,CAAC;AAkKF,qBACa,mBAAmB;IAI5B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IALhC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAGnB,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAM9D,aAAa,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC;CAmKlF"}