@carlonicora/nestjs-neo4jsonapi 1.4.1 → 1.5.0

package/dist/agents/drift/nodes/followup.node.service.js

@@ -0,0 +1,174 @@
+"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.FollowUpNodeService = exports.defaultFollowupPrompt = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const zod_1 = require("zod");
+const llm_service_1 = require("../../../core/llm/services/llm.service");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+const community_repository_1 = require("../../../foundations/community/repositories/community.repository");
+exports.defaultFollowupPrompt = `
+You are a knowledge analyst conducting a detailed investigation.
+
+## Your Task
+
+Given a follow-up question and community context, provide:
+1. A detailed answer to the specific question
+2. Additional follow-up questions if the investigation should continue
+
+## Guidelines
+
+- Focus on answering the specific follow-up question
+- Use entity details and relationships from the community members
+- Be specific and cite relevant entities when possible
+- Only suggest more follow-up questions if there are clear gaps to explore
+
+## Output
+
+Provide:
+- **answer**: Detailed answer to the follow-up question (100-300 words)
+- **additionalQuestions**: 0-2 additional questions if further investigation is needed
+- **shouldContinue**: Whether the investigation should continue (true if important gaps remain)
+`;
+const outputSchema = zod_1.z.object({
+    answer: zod_1.z.string().describe("Detailed answer to the follow-up question (100-300 words)"),
+    additionalQuestions: zod_1.z.array(zod_1.z.string()).describe("0-2 additional questions if further investigation is needed"),
+    shouldContinue: zod_1.z.boolean().describe("Whether the investigation should continue"),
+});
+const inputSchema = zod_1.z.object({
+    originalQuestion: zod_1.z.string().describe("The original user question"),
+    followUpQuestion: zod_1.z.string().describe("The current follow-up question to answer"),
+    priorContext: zod_1.z.string().describe("Context gathered from prior investigation steps"),
+    communityDetails: zod_1.z.string().describe("Details about community members and relationships"),
+});
+let FollowUpNodeService = class FollowUpNodeService {
+    constructor(llmService, communityRepository, logger, configService) {
+        this.llmService = llmService;
+        this.communityRepository = communityRepository;
+        this.logger = logger;
+        this.configService = configService;
+        this.maxQuestionsPerStep = 3;
+        const prompts = this.configService.get("prompts");
+        this.systemPrompt = prompts?.driftFollowup ?? exports.defaultFollowupPrompt;
+    }
+    async execute(params) {
+        const { state } = params;
+        const currentIndex = state.currentFollowUpIndex;
+        const currentDepth = state.currentDepth;
+        this.logger.debug(`FollowUp Node: processing question ${currentIndex + 1}/${state.followUpQuestions.length} at depth ${currentDepth}`, "FollowUpNodeService");
+        // Check if we've processed all questions at current depth
+        if (currentIndex >= state.followUpQuestions.length) {
+            // Check if we have additional questions from previous answers and haven't reached max depth
+            const additionalQuestions = this.collectAdditionalQuestions(state.followUpAnswers);
+            if (additionalQuestions.length > 0 && currentDepth + 1 < state.maxDepth) {
+                // Move to next depth level with additional questions
+                return {
+                    hops: 1,
+                    followUpQuestions: additionalQuestions.slice(0, this.maxQuestionsPerStep),
+                    currentFollowUpIndex: 0,
+                    currentDepth: currentDepth + 1,
+                    nextStep: "followup",
+                };
+            }
+            // No more questions to process
+            return {
+                hops: 1,
+                nextStep: "synthesis",
+            };
+        }
+        // Process current follow-up question
+        const currentQuestion = state.followUpQuestions[currentIndex];
+        const communityDetails = await this.gatherCommunityDetails(state.matchedCommunities.map((c) => c.id));
+        const inputParams = {
+            originalQuestion: state.question,
+            followUpQuestion: currentQuestion,
+            priorContext: state.priorContext,
+            communityDetails,
+        };
+        const llmResponse = await this.llmService.call({
+            inputSchema: inputSchema,
+            inputParams: inputParams,
+            outputSchema: outputSchema,
+            systemPrompts: [this.systemPrompt],
+            temperature: 0.3,
+        });
+        // Create the follow-up answer record
+        const followUpAnswer = {
+            question: currentQuestion,
+            answer: llmResponse.answer,
+            depth: currentDepth,
+            additionalQuestions: llmResponse.additionalQuestions,
+            shouldContinue: llmResponse.shouldContinue,
+        };
+        // Update prior context with this answer
+        const updatedPriorContext = `${state.priorContext}\n\nQ: ${currentQuestion}\nA: ${llmResponse.answer}`;
+        this.logger.debug(`FollowUp Node complete: answered question, ${llmResponse.additionalQuestions.length} additional questions`, "FollowUpNodeService");
+        return {
+            hops: 1,
+            followUpAnswers: [followUpAnswer],
+            priorContext: updatedPriorContext,
+            currentFollowUpIndex: currentIndex + 1,
+            tokens: llmResponse.tokenUsage,
+            nextStep: "followup", // Continue processing follow-ups
+        };
+    }
+    /**
+     * Collect additional questions from follow-up answers that should continue
+     */
+    collectAdditionalQuestions(followUpAnswers) {
+        const questions = [];
+        for (const answer of followUpAnswers) {
+            if (answer.shouldContinue && answer.additionalQuestions.length > 0) {
+                questions.push(...answer.additionalQuestions);
+            }
+        }
+        return questions;
+    }
+    /**
+     * Gather detailed information about communities for local search
+     */
+    async gatherCommunityDetails(communityIds) {
+        const details = [];
+        for (const communityId of communityIds.slice(0, 3)) {
+            try {
+                const community = await this.communityRepository.findById(communityId);
+                if (!community)
+                    continue;
+                const members = await this.communityRepository.findMemberKeyConcepts(communityId);
+                const relationships = await this.communityRepository.findMemberRelationships(communityId);
+                const memberDetails = members
+                    .map((m) => {
+                    const desc = m.description ? ` - ${m.description}` : "";
+                    return `  - ${m.value}${desc}`;
+                })
+                    .join("\n");
+                const relationshipDetails = relationships.length > 0
+                    ? relationships.map((r) => `  - ${r.keyConcept1} <-> ${r.keyConcept2}`).join("\n")
+                    : "  (no explicit relationships)";
+                details.push(`## ${community.name}\n\nMembers:\n${memberDetails}\n\nRelationships:\n${relationshipDetails}`);
+            }
+            catch (error) {
+                this.logger.warn(`Failed to gather details for community ${communityId}: ${error.message}`);
+            }
+        }
+        return details.join("\n\n---\n\n");
+    }
+};
+exports.FollowUpNodeService = FollowUpNodeService;
+exports.FollowUpNodeService = FollowUpNodeService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [llm_service_1.LLMService,
+        community_repository_1.CommunityRepository,
+        logging_service_1.AppLoggingService,
+        config_1.ConfigService])
+], FollowUpNodeService);
+//# sourceMappingURL=followup.node.service.js.map

package/dist/agents/drift/nodes/followup.node.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"followup.node.service.js","sourceRoot":"","sources":["../../../../src/agents/drift/nodes/followup.node.service.ts"],"names":[],"mappings":"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"}

package/dist/agents/drift/nodes/hyde.node.service.d.ts

@@ -0,0 +1,21 @@
+import { ConfigService } from "@nestjs/config";
+import { BaseConfigInterface } from "../../../config/interfaces";
+import { EmbedderService } from "../../../core";
+import { LLMService } from "../../../core/llm/services/llm.service";
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { CommunityRepository } from "../../../foundations/community/repositories/community.repository";
+import { DriftContext, DriftContextState } from "../contexts/drift.context";
+export declare const defaultHydePrompt = "\nYou are a knowledge synthesis expert. Given a question, generate a hypothetical answer\nthat would appear in a community summary report.\n\n## Context\n\nCommunity summaries are narrative reports that describe clusters of related entities\nfrom a knowledge graph. They typically:\n- Identify the main theme or domain\n- Describe key entities and their roles\n- Explain relationships between entities\n- Provide contextual information\n\n## Your Task\n\nGenerate a hypothetical answer to the question as if it were extracted from a\ncommunity summary report. The answer should:\n- Be written in the same style as a community report\n- Include relevant entity names and relationships\n- Provide context and explanation\n- Be comprehensive but concise (100-200 words)\n\n## Important\n\nDo NOT try to answer the question factually. Generate a HYPOTHETICAL answer\nthat captures the TYPE of information that would answer this question.\n";
+export declare class HydeNodeService {
+    private readonly llmService;
+    private readonly embedderService;
+    private readonly communityRepository;
+    private readonly logger;
+    private readonly configService;
+    private readonly systemPrompt;
+    constructor(llmService: LLMService, embedderService: EmbedderService, communityRepository: CommunityRepository, logger: AppLoggingService, configService: ConfigService<BaseConfigInterface>);
+    execute(params: {
+        state: typeof DriftContext.State;
+    }): Promise<Partial<DriftContextState>>;
+}
+//# sourceMappingURL=hyde.node.service.d.ts.map

package/dist/agents/drift/nodes/hyde.node.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.node.service.d.ts","sourceRoot":"","sources":["../../../../src/agents/drift/nodes/hyde.node.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,mBAAmB,EAA0B,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kEAAkE,CAAC;AACvG,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE5E,eAAO,MAAM,iBAAiB,46BA0B7B,CAAC;AAaF,qBACa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAPhC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAGnB,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,eAAe,EAChC,mBAAmB,EAAE,mBAAmB,EACxC,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAM9D,OAAO,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,YAAY,CAAC,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;CA8CjG"}

package/dist/agents/drift/nodes/hyde.node.service.js

@@ -0,0 +1,114 @@
+"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.HydeNodeService = exports.defaultHydePrompt = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const zod_1 = require("zod");
+const core_1 = require("../../../core");
+const llm_service_1 = require("../../../core/llm/services/llm.service");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+const community_repository_1 = require("../../../foundations/community/repositories/community.repository");
+exports.defaultHydePrompt = `
+You are a knowledge synthesis expert. Given a question, generate a hypothetical answer
+that would appear in a community summary report.
+
+## Context
+
+Community summaries are narrative reports that describe clusters of related entities
+from a knowledge graph. They typically:
+- Identify the main theme or domain
+- Describe key entities and their roles
+- Explain relationships between entities
+- Provide contextual information
+
+## Your Task
+
+Generate a hypothetical answer to the question as if it were extracted from a
+community summary report. The answer should:
+- Be written in the same style as a community report
+- Include relevant entity names and relationships
+- Provide context and explanation
+- Be comprehensive but concise (100-200 words)
+
+## Important
+
+Do NOT try to answer the question factually. Generate a HYPOTHETICAL answer
+that captures the TYPE of information that would answer this question.
+`;
+const outputSchema = zod_1.z.object({
+    hypotheticalAnswer: zod_1.z
+        .string()
+        .describe("A hypothetical answer written in the style of a community summary report (100-200 words)"),
+});
+const inputSchema = zod_1.z.object({
+    question: zod_1.z.string().describe("The user's question to generate a hypothetical answer for"),
+    sampleSummary: zod_1.z.string().optional().describe("An optional sample community summary for style reference"),
+});
+let HydeNodeService = class HydeNodeService {
+    constructor(llmService, embedderService, communityRepository, logger, configService) {
+        this.llmService = llmService;
+        this.embedderService = embedderService;
+        this.communityRepository = communityRepository;
+        this.logger = logger;
+        this.configService = configService;
+        const prompts = this.configService.get("prompts");
+        this.systemPrompt = prompts?.hydeGenerator ?? exports.defaultHydePrompt;
+    }
+    async execute(params) {
+        this.logger.debug(`HyDE Node: generating hypothetical answer for "${params.state.question}"`, "HydeNodeService");
+        // Optionally fetch a sample community summary for style reference
+        let sampleSummary;
+        try {
+            const communities = await this.communityRepository.findByLevel({ level: 1 });
+            if (communities.length > 0 && communities[0].summary) {
+                sampleSummary = communities[0].summary;
+            }
+        }
+        catch {
+            // Ignore - sample is optional
+        }
+        // Generate hypothetical answer via LLM
+        const inputParams = {
+            question: params.state.question,
+            sampleSummary,
+        };
+        const llmResponse = await this.llmService.call({
+            inputSchema: inputSchema,
+            inputParams: inputParams,
+            outputSchema: outputSchema,
+            systemPrompts: [this.systemPrompt],
+            temperature: 0.5,
+        });
+        // Generate embedding for the hypothetical answer
+        const embedding = await this.embedderService.vectoriseText({
+            text: llmResponse.hypotheticalAnswer,
+        });
+        this.logger.debug(`HyDE Node complete: generated ${llmResponse.hypotheticalAnswer.length} char answer`, "HydeNodeService");
+        return {
+            hops: 1,
+            hypotheticalAnswer: llmResponse.hypotheticalAnswer,
+            hydeEmbedding: embedding,
+            tokens: llmResponse.tokenUsage,
+            nextStep: "community_search",
+        };
+    }
+};
+exports.HydeNodeService = HydeNodeService;
+exports.HydeNodeService = HydeNodeService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [llm_service_1.LLMService,
+        core_1.EmbedderService,
+        community_repository_1.CommunityRepository,
+        logging_service_1.AppLoggingService,
+        config_1.ConfigService])
+], HydeNodeService);
+//# sourceMappingURL=hyde.node.service.js.map

package/dist/agents/drift/nodes/hyde.node.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hyde.node.service.js","sourceRoot":"","sources":["../../../../src/agents/drift/nodes/hyde.node.service.ts"],"names":[],"mappings":"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"}

package/dist/agents/drift/nodes/primer.answer.node.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 { DriftContext, DriftContextState } from "../contexts/drift.context";
+export declare const defaultPrimerPrompt = "\nYou are a knowledge synthesis expert analyzing community reports from a knowledge graph.\n\n## Your Task\n\nGiven a question and relevant community summaries, provide:\n1. An initial broad answer based on the community context\n2. Follow-up questions that would help drill deeper into the specifics\n\n## Guidelines\n\n- Synthesize information from multiple community summaries\n- Provide a comprehensive but high-level answer\n- Generate follow-up questions that target specific details\n- Rate your confidence in the answer\n\n## Output\n\nProvide:\n- **answer**: Your initial answer synthesizing the community context (200-400 words)\n- **followUpQuestions**: 2-4 specific questions to drill deeper\n- **confidence**: Your confidence score (0-100) based on relevance of matched communities\n";
+export declare class PrimerAnswerNodeService {
+    private readonly llmService;
+    private readonly logger;
+    private readonly configService;
+    private readonly systemPrompt;
+    constructor(llmService: LLMService, logger: AppLoggingService, configService: ConfigService<BaseConfigInterface>);
+    execute(params: {
+        state: typeof DriftContext.State;
+    }): Promise<Partial<DriftContextState>>;
+}
+//# sourceMappingURL=primer.answer.node.service.d.ts.map

package/dist/agents/drift/nodes/primer.answer.node.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primer.answer.node.service.d.ts","sourceRoot":"","sources":["../../../../src/agents/drift/nodes/primer.answer.node.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,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE5E,eAAO,MAAM,mBAAmB,iyBAsB/B,CAAC;AAgBF,qBACa,uBAAuB;IAIhC,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,OAAO,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,YAAY,CAAC,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAqDjG"}

package/dist/agents/drift/nodes/primer.answer.node.service.js

@@ -0,0 +1,110 @@
+"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.PrimerAnswerNodeService = exports.defaultPrimerPrompt = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const zod_1 = require("zod");
+const llm_service_1 = require("../../../core/llm/services/llm.service");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+exports.defaultPrimerPrompt = `
+You are a knowledge synthesis expert analyzing community reports from a knowledge graph.
+
+## Your Task
+
+Given a question and relevant community summaries, provide:
+1. An initial broad answer based on the community context
+2. Follow-up questions that would help drill deeper into the specifics
+
+## Guidelines
+
+- Synthesize information from multiple community summaries
+- Provide a comprehensive but high-level answer
+- Generate follow-up questions that target specific details
+- Rate your confidence in the answer
+
+## Output
+
+Provide:
+- **answer**: Your initial answer synthesizing the community context (200-400 words)
+- **followUpQuestions**: 2-4 specific questions to drill deeper
+- **confidence**: Your confidence score (0-100) based on relevance of matched communities
+`;
+const outputSchema = zod_1.z.object({
+    answer: zod_1.z.string().describe("Initial broad answer synthesizing the community context (200-400 words)"),
+    followUpQuestions: zod_1.z
+        .array(zod_1.z.string())
+        .describe("2-4 specific follow-up questions to drill deeper into the topic"),
+    confidence: zod_1.z.number().min(0).max(100).describe("Confidence score based on relevance of matched communities"),
+});
+const inputSchema = zod_1.z.object({
+    question: zod_1.z.string().describe("The user's original question"),
+    communitySummaries: zod_1.z.string().describe("Relevant community summaries from vector search"),
+    communityCount: zod_1.z.number().describe("Number of communities matched"),
+});
+let PrimerAnswerNodeService = class PrimerAnswerNodeService {
+    constructor(llmService, logger, configService) {
+        this.llmService = llmService;
+        this.logger = logger;
+        this.configService = configService;
+        const prompts = this.configService.get("prompts");
+        this.systemPrompt = prompts?.driftPrimer ?? exports.defaultPrimerPrompt;
+    }
+    async execute(params) {
+        this.logger.debug(`Primer Answer Node: generating initial answer from ${params.state.matchedCommunities.length} communities`, "PrimerAnswerNodeService");
+        // Handle case where no communities were found
+        if (params.state.matchedCommunities.length === 0) {
+            return {
+                hops: 1,
+                initialAnswer: "No relevant community context found for this question.",
+                followUpQuestions: [],
+                confidence: 0,
+                priorContext: "",
+                nextStep: "synthesis",
+            };
+        }
+        const inputParams = {
+            question: params.state.question,
+            communitySummaries: params.state.communitySummaries,
+            communityCount: params.state.matchedCommunities.length,
+        };
+        const llmResponse = await this.llmService.call({
+            inputSchema: inputSchema,
+            inputParams: inputParams,
+            outputSchema: outputSchema,
+            systemPrompts: [this.systemPrompt],
+            temperature: 0.3,
+        });
+        this.logger.debug(`Primer Answer Node complete: ${llmResponse.followUpQuestions.length} follow-ups, confidence: ${llmResponse.confidence}`, "PrimerAnswerNodeService");
+        // Determine next step based on follow-up questions
+        const hasFollowUps = llmResponse.followUpQuestions.length > 0;
+        const nextStep = hasFollowUps ? "followup" : "synthesis";
+        return {
+            hops: 1,
+            initialAnswer: llmResponse.answer,
+            followUpQuestions: llmResponse.followUpQuestions,
+            confidence: llmResponse.confidence,
+            priorContext: llmResponse.answer,
+            currentFollowUpIndex: 0,
+            currentDepth: 0,
+            tokens: llmResponse.tokenUsage,
+            nextStep,
+        };
+    }
+};
+exports.PrimerAnswerNodeService = PrimerAnswerNodeService;
+exports.PrimerAnswerNodeService = PrimerAnswerNodeService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [llm_service_1.LLMService,
+        logging_service_1.AppLoggingService,
+        config_1.ConfigService])
+], PrimerAnswerNodeService);
+//# sourceMappingURL=primer.answer.node.service.js.map

package/dist/agents/drift/nodes/primer.answer.node.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primer.answer.node.service.js","sourceRoot":"","sources":["../../../../src/agents/drift/nodes/primer.answer.node.service.ts"],"names":[],"mappings":"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"}

package/dist/agents/drift/nodes/synthesis.node.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 { DriftContext, DriftContextState } from "../contexts/drift.context";
+export declare const defaultSynthesisPrompt = "\nYou are a knowledge synthesis expert producing a final comprehensive answer.\n\n## Your Task\n\nSynthesize all gathered information into a final, comprehensive answer to the user's question.\n\n## Input\n\nYou will receive:\n1. The original question\n2. An initial broad answer from community context\n3. Detailed answers from follow-up investigations\n\n## Guidelines\n\n- Integrate all relevant information cohesively\n- Structure your response clearly\n- Cite specific entities and relationships when relevant\n- Acknowledge any limitations or gaps in the available information\n- Be comprehensive but concise\n\n## Output\n\nProvide a final comprehensive answer (300-600 words) that addresses the user's question\nusing all available context.\n";
+export declare class SynthesisNodeService {
+    private readonly llmService;
+    private readonly logger;
+    private readonly configService;
+    private readonly systemPrompt;
+    constructor(llmService: LLMService, logger: AppLoggingService, configService: ConfigService<BaseConfigInterface>);
+    execute(params: {
+        state: typeof DriftContext.State;
+    }): Promise<Partial<DriftContextState>>;
+}
+//# sourceMappingURL=synthesis.node.service.d.ts.map

package/dist/agents/drift/nodes/synthesis.node.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesis.node.service.d.ts","sourceRoot":"","sources":["../../../../src/agents/drift/nodes/synthesis.node.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,YAAY,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAE5E,eAAO,MAAM,sBAAsB,mvBA0BlC,CAAC;AAaF,qBACa,oBAAoB;IAI7B,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,OAAO,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,YAAY,CAAC,KAAK,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;CA6CjG"}

package/dist/agents/drift/nodes/synthesis.node.service.js

@@ -0,0 +1,105 @@
+"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.SynthesisNodeService = exports.defaultSynthesisPrompt = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const zod_1 = require("zod");
+const llm_service_1 = require("../../../core/llm/services/llm.service");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+exports.defaultSynthesisPrompt = `
+You are a knowledge synthesis expert producing a final comprehensive answer.
+
+## Your Task
+
+Synthesize all gathered information into a final, comprehensive answer to the user's question.
+
+## Input
+
+You will receive:
+1. The original question
+2. An initial broad answer from community context
+3. Detailed answers from follow-up investigations
+
+## Guidelines
+
+- Integrate all relevant information cohesively
+- Structure your response clearly
+- Cite specific entities and relationships when relevant
+- Acknowledge any limitations or gaps in the available information
+- Be comprehensive but concise
+
+## Output
+
+Provide a final comprehensive answer (300-600 words) that addresses the user's question
+using all available context.
+`;
+const outputSchema = zod_1.z.object({
+    finalAnswer: zod_1.z.string().describe("Final comprehensive answer synthesizing all gathered information (300-600 words)"),
+});
+const inputSchema = zod_1.z.object({
+    question: zod_1.z.string().describe("The original user question"),
+    initialAnswer: zod_1.z.string().describe("Initial broad answer from community context"),
+    followUpAnswers: zod_1.z.string().describe("Detailed answers from follow-up investigations"),
+    confidence: zod_1.z.number().describe("Overall confidence from the primer phase"),
+});
+let SynthesisNodeService = class SynthesisNodeService {
+    constructor(llmService, logger, configService) {
+        this.llmService = llmService;
+        this.logger = logger;
+        this.configService = configService;
+        const prompts = this.configService.get("prompts");
+        this.systemPrompt = prompts?.driftSearch ?? exports.defaultSynthesisPrompt;
+    }
+    async execute(params) {
+        this.logger.debug(`Synthesis Node: synthesizing answer from ${params.state.followUpAnswers.length} follow-ups`, "SynthesisNodeService");
+        // Handle case where no communities were matched
+        if (params.state.matchedCommunities.length === 0) {
+            return {
+                hops: 1,
+                finalAnswer: params.state.initialAnswer || "No relevant information found in the knowledge base.",
+                nextStep: "end",
+            };
+        }
+        // Format follow-up answers for LLM
+        const followUpAnswers = params.state.followUpAnswers.length > 0
+            ? params.state.followUpAnswers.map((f) => `**Q: ${f.question}**\n${f.answer}`).join("\n\n")
+            : "No follow-up investigations were conducted.";
+        const inputParams = {
+            question: params.state.question,
+            initialAnswer: params.state.initialAnswer,
+            followUpAnswers,
+            confidence: params.state.confidence,
+        };
+        const llmResponse = await this.llmService.call({
+            inputSchema: inputSchema,
+            inputParams: inputParams,
+            outputSchema: outputSchema,
+            systemPrompts: [this.systemPrompt],
+            temperature: 0.3,
+        });
+        this.logger.debug(`Synthesis Node complete: generated final answer`, "SynthesisNodeService");
+        return {
+            hops: 1,
+            finalAnswer: llmResponse.finalAnswer,
+            tokens: llmResponse.tokenUsage,
+            nextStep: "end",
+        };
+    }
+};
+exports.SynthesisNodeService = SynthesisNodeService;
+exports.SynthesisNodeService = SynthesisNodeService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [llm_service_1.LLMService,
+        logging_service_1.AppLoggingService,
+        config_1.ConfigService])
+], SynthesisNodeService);
+//# sourceMappingURL=synthesis.node.service.js.map

package/dist/agents/drift/nodes/synthesis.node.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synthesis.node.service.js","sourceRoot":"","sources":["../../../../src/agents/drift/nodes/synthesis.node.service.ts"],"names":[],"mappings":"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"}