@carlonicora/nestjs-neo4jsonapi 0.0.1

package/dist/agents/prompts/prompt.interfaces.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Interfaces for agent prompt customization
+ *
+ * These interfaces define the structure for custom prompts that can be
+ * passed to agent modules via forRoot() method.
+ *
+ * All prompts are OPTIONAL - the library includes default prompts that
+ * work out of the box.
+ */
+/**
+ * Custom prompts for the Contextualiser agent (GraphRAG)
+ *
+ * The Contextualiser uses multiple nodes to traverse the knowledge graph:
+ * - questionRefiner: Refines user questions based on conversation history
+ * - rationalPlan: Creates a rational plan to answer the question
+ * - keyConcepts: Scores key concepts for relevance
+ * - atomicFacts: Evaluates atomic facts for context
+ * - chunk: Assesses text chunks for information
+ * - chunkVector: (if using vector-based chunk retrieval)
+ */
+export interface ContextualiserPromptsOptions {
+    /**
+     * Prompt for refining user questions based on conversation history
+     */
+    questionRefiner?: string;
+    /**
+     * Prompt for creating a rational plan to answer the question
+     */
+    rationalPlan?: string;
+    /**
+     * Prompt for scoring key concepts for relevance
+     */
+    keyConcepts?: string;
+    /**
+     * Prompt for evaluating atomic facts for context
+     */
+    atomicFacts?: string;
+    /**
+     * Prompt for assessing text chunks for information
+     */
+    chunk?: string;
+    /**
+     * Prompt for vector-based chunk assessment (optional)
+     */
+    chunkVector?: string;
+}
+/**
+ * Custom prompts for the Summariser agent
+ *
+ * The Summariser uses a map-reduce pattern:
+ * - map: Summarizes individual chunks
+ * - combine: Combines multiple summaries into one
+ * - tldr: Creates a very short one-sentence summary
+ */
+export interface SummariserPromptsOptions {
+    /**
+     * Prompt for summarizing individual chunks (map phase)
+     */
+    map?: string;
+    /**
+     * Prompt for combining multiple summaries (reduce phase)
+     */
+    combine?: string;
+    /**
+     * Prompt for creating a one-sentence TLDR
+     */
+    tldr?: string;
+}
+/**
+ * Options for GraphCreatorModule.forRoot()
+ */
+export interface GraphCreatorModuleOptions {
+    /**
+     * Custom prompt for extracting atomic facts and key concepts
+     */
+    prompt?: string;
+}
+/**
+ * Options for ContextualiserModule.forRoot()
+ */
+export interface ContextualiserModuleOptions {
+    /**
+     * Custom prompts for Contextualiser nodes
+     */
+    prompts?: ContextualiserPromptsOptions;
+}
+/**
+ * Options for ResponderModule.forRoot()
+ */
+export interface ResponderModuleOptions {
+    /**
+     * Custom prompt for generating final answers
+     */
+    prompt?: string;
+}
+/**
+ * Options for SummariserModule.forRoot()
+ */
+export interface SummariserModuleOptions {
+    /**
+     * Custom prompts for Summariser operations
+     */
+    prompts?: SummariserPromptsOptions;
+}
+/**
+ * Combined options for all agent prompts
+ *
+ * Can be used with AgentsModule.forRoot() for centralized configuration
+ */
+export interface AgentPromptsOptions {
+    /**
+     * Custom prompt for GraphCreator agent
+     */
+    graphCreator?: string;
+    /**
+     * Custom prompts for Contextualiser agent (GraphRAG)
+     */
+    contextualiser?: ContextualiserPromptsOptions;
+    /**
+     * Custom prompt for Responder agent
+     */
+    responder?: string;
+    /**
+     * Custom prompts for Summariser agent
+     */
+    summariser?: SummariserPromptsOptions;
+}
+//# sourceMappingURL=prompt.interfaces.d.ts.map

package/dist/agents/prompts/prompt.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.interfaces.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/prompt.interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;OAEG;IACH,OAAO,CAAC,EAAE,4BAA4B,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,CAAC,EAAE,wBAAwB,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,cAAc,CAAC,EAAE,4BAA4B,CAAC;IAE9C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,UAAU,CAAC,EAAE,wBAAwB,CAAC;CACvC"}

package/dist/agents/prompts/prompt.interfaces.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Interfaces for agent prompt customization
+ *
+ * These interfaces define the structure for custom prompts that can be
+ * passed to agent modules via forRoot() method.
+ *
+ * All prompts are OPTIONAL - the library includes default prompts that
+ * work out of the box.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=prompt.interfaces.js.map

package/dist/agents/prompts/prompt.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.interfaces.js","sourceRoot":"","sources":["../../../src/agents/prompts/prompt.interfaces.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/agents/prompts/prompt.tokens.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Injection tokens for agent prompts
+ * These tokens allow consumers to provide custom prompts for each agent
+ */
+export declare const GRAPH_CREATOR_PROMPT: unique symbol;
+export declare const SUMMARISER_MAP_PROMPT: unique symbol;
+export declare const SUMMARISER_COMBINE_PROMPT: unique symbol;
+export declare const SUMMARISER_TLDR_PROMPT: unique symbol;
+export declare const CONTEXTUALISER_QUESTION_REFINER_PROMPT: unique symbol;
+export declare const CONTEXTUALISER_RATIONAL_PROMPT: unique symbol;
+export declare const CONTEXTUALISER_CHUNK_PROMPT: unique symbol;
+export declare const CONTEXTUALISER_CHUNK_VECTOR_PROMPT: unique symbol;
+export declare const CONTEXTUALISER_KEYCONCEPTS_PROMPT: unique symbol;
+export declare const CONTEXTUALISER_ATOMICFACTS_PROMPT: unique symbol;
+export declare const RESPONDER_ANSWER_PROMPT: unique symbol;
+//# sourceMappingURL=prompt.tokens.d.ts.map

package/dist/agents/prompts/prompt.tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.tokens.d.ts","sourceRoot":"","sources":["../../../src/agents/prompts/prompt.tokens.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AAGnE,eAAO,MAAM,qBAAqB,eAAkC,CAAC;AACrE,eAAO,MAAM,yBAAyB,eAAsC,CAAC;AAC7E,eAAO,MAAM,sBAAsB,eAAmC,CAAC;AAGvE,eAAO,MAAM,sCAAsC,eAAmD,CAAC;AACvG,eAAO,MAAM,8BAA8B,eAA2C,CAAC;AACvF,eAAO,MAAM,2BAA2B,eAAwC,CAAC;AACjF,eAAO,MAAM,kCAAkC,eAA+C,CAAC;AAC/F,eAAO,MAAM,iCAAiC,eAA8C,CAAC;AAC7F,eAAO,MAAM,iCAAiC,eAA8C,CAAC;AAG7F,eAAO,MAAM,uBAAuB,eAAoC,CAAC"}

package/dist/agents/prompts/prompt.tokens.js

@@ -0,0 +1,23 @@
+"use strict";
+/**
+ * Injection tokens for agent prompts
+ * These tokens allow consumers to provide custom prompts for each agent
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESPONDER_ANSWER_PROMPT = exports.CONTEXTUALISER_ATOMICFACTS_PROMPT = exports.CONTEXTUALISER_KEYCONCEPTS_PROMPT = exports.CONTEXTUALISER_CHUNK_VECTOR_PROMPT = exports.CONTEXTUALISER_CHUNK_PROMPT = exports.CONTEXTUALISER_RATIONAL_PROMPT = exports.CONTEXTUALISER_QUESTION_REFINER_PROMPT = exports.SUMMARISER_TLDR_PROMPT = exports.SUMMARISER_COMBINE_PROMPT = exports.SUMMARISER_MAP_PROMPT = exports.GRAPH_CREATOR_PROMPT = void 0;
+// Graph Creator prompts
+exports.GRAPH_CREATOR_PROMPT = Symbol("GRAPH_CREATOR_PROMPT");
+// Summariser prompts
+exports.SUMMARISER_MAP_PROMPT = Symbol("SUMMARISER_MAP_PROMPT");
+exports.SUMMARISER_COMBINE_PROMPT = Symbol("SUMMARISER_COMBINE_PROMPT");
+exports.SUMMARISER_TLDR_PROMPT = Symbol("SUMMARISER_TLDR_PROMPT");
+// Contextualiser prompts
+exports.CONTEXTUALISER_QUESTION_REFINER_PROMPT = Symbol("CONTEXTUALISER_QUESTION_REFINER_PROMPT");
+exports.CONTEXTUALISER_RATIONAL_PROMPT = Symbol("CONTEXTUALISER_RATIONAL_PROMPT");
+exports.CONTEXTUALISER_CHUNK_PROMPT = Symbol("CONTEXTUALISER_CHUNK_PROMPT");
+exports.CONTEXTUALISER_CHUNK_VECTOR_PROMPT = Symbol("CONTEXTUALISER_CHUNK_VECTOR_PROMPT");
+exports.CONTEXTUALISER_KEYCONCEPTS_PROMPT = Symbol("CONTEXTUALISER_KEYCONCEPTS_PROMPT");
+exports.CONTEXTUALISER_ATOMICFACTS_PROMPT = Symbol("CONTEXTUALISER_ATOMICFACTS_PROMPT");
+// Responder prompts
+exports.RESPONDER_ANSWER_PROMPT = Symbol("RESPONDER_ANSWER_PROMPT");
+//# sourceMappingURL=prompt.tokens.js.map

package/dist/agents/prompts/prompt.tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.tokens.js","sourceRoot":"","sources":["../../../src/agents/prompts/prompt.tokens.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,wBAAwB;AACX,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAEnE,qBAAqB;AACR,QAAA,qBAAqB,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;AACxD,QAAA,yBAAyB,GAAG,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAChE,QAAA,sBAAsB,GAAG,MAAM,CAAC,wBAAwB,CAAC,CAAC;AAEvE,yBAAyB;AACZ,QAAA,sCAAsC,GAAG,MAAM,CAAC,wCAAwC,CAAC,CAAC;AAC1F,QAAA,8BAA8B,GAAG,MAAM,CAAC,gCAAgC,CAAC,CAAC;AAC1E,QAAA,2BAA2B,GAAG,MAAM,CAAC,6BAA6B,CAAC,CAAC;AACpE,QAAA,kCAAkC,GAAG,MAAM,CAAC,oCAAoC,CAAC,CAAC;AAClF,QAAA,iCAAiC,GAAG,MAAM,CAAC,mCAAmC,CAAC,CAAC;AAChF,QAAA,iCAAiC,GAAG,MAAM,CAAC,mCAAmC,CAAC,CAAC;AAE7F,oBAAoB;AACP,QAAA,uBAAuB,GAAG,MAAM,CAAC,yBAAyB,CAAC,CAAC"}

package/dist/agents/responder/contexts/responder.answer.context.d.ts

@@ -0,0 +1,28 @@
+export declare const ResponderAnswerContext: import("@langchain/langgraph").AnnotationRoot<{
+    title: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    analysis: {
+        (): import("@langchain/langgraph").LastValue<string>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string, string>): import("@langchain/langgraph").BinaryOperatorAggregate<string, string>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    answer: {
+        (): import("@langchain/langgraph").LastValue<any>;
+        (annotation: import("@langchain/langgraph").SingleReducer<any, any>): import("@langchain/langgraph").BinaryOperatorAggregate<any, any>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    questions: {
+        (): import("@langchain/langgraph").LastValue<string[]>;
+        (annotation: import("@langchain/langgraph").SingleReducer<string[], string[]>): import("@langchain/langgraph").BinaryOperatorAggregate<string[], string[]>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+    hasAnswer: {
+        (): import("@langchain/langgraph").LastValue<boolean>;
+        (annotation: import("@langchain/langgraph").SingleReducer<boolean, boolean>): import("@langchain/langgraph").BinaryOperatorAggregate<boolean, boolean>;
+        Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
+    };
+}>;
+//# sourceMappingURL=responder.answer.context.d.ts.map

package/dist/agents/responder/contexts/responder.answer.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responder.answer.context.d.ts","sourceRoot":"","sources":["../../../../src/agents/responder/contexts/responder.answer.context.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;EAMjC,CAAC"}

package/dist/agents/responder/contexts/responder.answer.context.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResponderAnswerContext = void 0;
+const langgraph_1 = require("@langchain/langgraph");
+exports.ResponderAnswerContext = langgraph_1.Annotation.Root({
+    title: (langgraph_1.Annotation),
+    analysis: (langgraph_1.Annotation),
+    answer: (langgraph_1.Annotation),
+    questions: (langgraph_1.Annotation),
+    hasAnswer: (langgraph_1.Annotation),
+});
+//# sourceMappingURL=responder.answer.context.js.map

package/dist/agents/responder/contexts/responder.answer.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responder.answer.context.js","sourceRoot":"","sources":["../../../../src/agents/responder/contexts/responder.answer.context.ts"],"names":[],"mappings":";;;AAAA,oDAAkD;AAErC,QAAA,sBAAsB,GAAG,sBAAU,CAAC,IAAI,CAAC;IACpD,KAAK,EAAE,CAAA,sBAAkB,CAAA;IACzB,QAAQ,EAAE,CAAA,sBAAkB,CAAA;IAC5B,MAAM,EAAE,CAAA,sBAAe,CAAA;IACvB,SAAS,EAAE,CAAA,sBAAoB,CAAA;IAC/B,SAAS,EAAE,CAAA,sBAAmB,CAAA;CAC/B,CAAC,CAAC"}