@farukada/langchain-ts-rms 0.1.0

package/dist/app/graph/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../../src/app/graph/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,mBAAmB,EAGzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAYtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAC;AAUrF,8EAA8E;AAC9E,eAAO,MAAM,cAAc;;;;;;;;;;CAUjB,CAAC;AAEX,MAAM,WAAW,YAAY;IAC3B,kBAAkB,EAAE,mBAAmB,CAAC;IAExC,mEAAmE;IACnE,SAAS,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACtC,mEAAmE;IACnE,UAAU,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAC7C,0CAA0C;IAC1C,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC;;;;OAIG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAGnC,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,uDAAuD;IACvD,kBAAkB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnF,4DAA4D;IAC5D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D;;;OAGG;IACH,cAAc,CAAC,EAAE,mBAAmB,CAAC;CACtC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAsEnD"}

package/dist/app/graph/workflow.js

@@ -0,0 +1,468 @@
+import { StateGraph, START, END, interrupt, MemorySaver, } from "@langchain/langgraph";
+import { RmsStateAnnotation } from "../state/schema.js";
+import { evaluateFreshness } from "../freshness/evaluator.js";
+import { checkGuardrail } from "../governance/guardrails.js";
+import { summarizeSearchResults } from "../summarization/summarizer.js";
+import { synthesizeSummary } from "../summarization/synthesizer.js";
+import { evaluateQueryRelevance, MAX_REWRITES } from "../queryRewriting/rewriter.js";
+import { rerankSearchResults } from "../reranking/reranker.js";
+import { planSearchQueries } from "../queryPlanning/planner.js";
+import { performSearch } from "../../infra/search/searxngClient.js";
+import { buildResearch, buildCompositeSummary } from "../../domain/researchUtils.js";
+import { createChatModelProvider } from "../../infra/chat/chatModelProvider.js";
+import { createEmbeddingProvider } from "../../infra/embeddings/embeddingProvider.js";
+import { logInfo, logWarn, logError, ErrorCodes, withNodeTiming, } from "../../infra/observability/tracing.js";
+/** Canonical node name constants used by both the graph and event mapping. */
+export const RMS_NODE_NAMES = {
+    FRESHNESS_CHECKER: "freshnessChecker",
+    GUARDRAIL: "guardrail",
+    QUERY_PLANNER: "queryPlanner",
+    SEARCHER: "searcher",
+    QUERY_REWRITER: "queryRewriter",
+    RERANKER: "reranker",
+    HUMAN_APPROVAL: "human_approval",
+    SUMMARIZER: "summarizer",
+    PERSISTER: "persister",
+};
+/**
+ * Builds the RMS LangGraph workflow:
+ * freshnessChecker -> (conditional) -> searcher -> summarizer -> persister
+ *
+ * RMS produces research summaries for autonomous agents.
+ * Guardrail gating and HITL interrupt are supported for sensitive queries.
+ */
+export function createRmsWorkflow(deps) {
+    const rawChatModel = deps.chatModel ?? createChatModelProvider();
+    const embeddings = deps.embeddings ?? createEmbeddingProvider();
+    // Wire token usage tracking: withConfig binds the collector as a callback
+    // so every LLM invocation (including withStructuredOutput) feeds usage metadata.
+    // The cast is safe because RunnableBinding forwards all calls to the underlying model.
+    const chatModel = (deps.tokenCollector
+        ? rawChatModel.withConfig({ callbacks: [deps.tokenCollector] })
+        : rawChatModel);
+    const checkpointer = deps.checkpointer ??
+        (() => {
+            const msg = "No durable checkpointer provided — using in-memory MemorySaver. " +
+                "State will be lost on process restart and HITL resume will not work.\n" +
+                "For production, inject a checkpointer via deps.checkpointer:\n" +
+                "  import { SqliteSaver } from '@langchain/langgraph-checkpoint-sqlite';\n" +
+                "  const checkpointer = SqliteSaver.fromConnString('rms.db');\n" +
+                "See: https://langchain-ai.github.io/langgraphjs/reference/classes/checkpoint_sqlite.SqliteSaver.html";
+            if (process.env["NODE_ENV"] === "production") {
+                throw new Error(msg);
+            }
+            logWarn(msg);
+            return new MemorySaver();
+        })();
+    const graph = new StateGraph(RmsStateAnnotation)
+        .addNode("freshnessChecker", freshnessCheckerNode(deps), {
+        retryPolicy: { maxAttempts: 3 },
+    })
+        .addNode("guardrail", guardrailNode())
+        .addNode("queryPlanner", queryPlannerNode(chatModel))
+        .addNode("searcher", searcherNode(), {
+        retryPolicy: { maxAttempts: 3 },
+    })
+        .addNode("queryRewriter", queryRewriterNode(chatModel))
+        .addNode("reranker", rerankerNode(embeddings))
+        .addNode("human_approval", humanApprovalNode(deps, checkpointer))
+        .addNode("summarizer", summarizerNode(chatModel), {
+        retryPolicy: { maxAttempts: 3 },
+    })
+        .addNode("persister", persisterNode(deps))
+        .addEdge(START, "freshnessChecker")
+        .addConditionalEdges("freshnessChecker", routeAfterFreshness, {
+        guardrail: "guardrail",
+        persister: "persister",
+    })
+        .addConditionalEdges("guardrail", routeAfterGuardrail, {
+        queryPlanner: "queryPlanner",
+        persister: "persister",
+    })
+        .addEdge("queryPlanner", "searcher")
+        .addEdge("searcher", "queryRewriter")
+        .addConditionalEdges("queryRewriter", routeAfterQueryRewriter, {
+        searcher: "searcher",
+        reranker: "reranker",
+    })
+        .addEdge("reranker", "summarizer")
+        .addConditionalEdges("summarizer", routeAfterSummarizer, {
+        human_approval: "human_approval",
+        persister: "persister",
+    })
+        .addEdge("human_approval", "persister")
+        .addEdge("persister", END);
+    return graph.compile({ checkpointer });
+}
+// ── Node Implementations ─────────────────────────────────────────────
+function freshnessCheckerNode(deps) {
+    const node = async (state) => {
+        const { subject, traceId, tenantId } = state;
+        return withNodeTiming("freshnessChecker", traceId, subject, async () => {
+            logInfo("Checking freshness", { node: "freshnessChecker", researchId: subject, traceId });
+            const freshness = await evaluateFreshness(subject, deps.researchRepository, { tenantId });
+            return {
+                cachedResearch: freshness.cachedResearch ?? undefined,
+                isFresh: freshness.isFresh,
+                currentPhase: "freshness",
+            };
+        });
+    };
+    return node;
+}
+/**
+ * Guards the subject against forbidden patterns before search.
+ * Sets `error` if blocked, which causes downstream routing to skip search.
+ */
+function guardrailNode() {
+    const node = async (state) => {
+        const { subject, traceId } = state;
+        return withNodeTiming("guardrail", traceId, subject, () => {
+            const check = checkGuardrail(subject);
+            if (!check.allowed) {
+                logWarn("Guardrail blocked research", {
+                    node: "guardrail",
+                    researchId: subject,
+                    reason: check.reason,
+                });
+                return { error: check.reason };
+            }
+            logInfo("Guardrail passed", { node: "guardrail", researchId: subject });
+            return {};
+        });
+    };
+    return node;
+}
+/**
+ * Generates optimized search queries from the subject before searching.
+ */
+function queryPlannerNode(chatModel) {
+    const node = async (state) => {
+        const { subject, traceId } = state;
+        return withNodeTiming("queryPlanner", traceId, subject, async () => {
+            const queries = await planSearchQueries(subject, chatModel, traceId);
+            return {
+                plannedQueries: queries,
+                currentPhase: "queryPlanning",
+            };
+        });
+    };
+    return node;
+}
+/**
+ * Executes web searches for all planned queries concurrently,
+ * merging and deduplicating results by URL.
+ *
+ * When a rewritten query is available (from the query rewriter loop),
+ * it takes precedence over planned queries.
+ */
+function searcherNode() {
+    const node = async (state) => {
+        const { subject, traceId, maxResults, rewrittenQuery, originalSubject, plannedQueries } = state;
+        return withNodeTiming("searcher", traceId, subject, async () => {
+            try {
+                // Determine which queries to execute
+                const queries = rewrittenQuery
+                    ? [rewrittenQuery]
+                    : plannedQueries.length > 0
+                        ? plannedQueries
+                        : [subject];
+                logInfo("Searching web", {
+                    node: "searcher",
+                    researchId: subject,
+                    traceId,
+                    queryCount: queries.length,
+                });
+                // Execute all queries concurrently
+                const perQueryLimit = Math.max(3, Math.ceil(maxResults / queries.length));
+                const allResults = await Promise.all(queries.map((q) => performSearch(q, { numResults: perQueryLimit }).catch((err) => {
+                    logWarn("Individual query search failed", {
+                        node: "searcher",
+                        query: q,
+                        error: err instanceof Error ? err.message : String(err),
+                    });
+                    return [];
+                })));
+                // Merge and deduplicate by URL, keeping the first occurrence
+                const seen = new Set();
+                const searchResults = allResults.flat().filter((r) => {
+                    if (seen.has(r.url))
+                        return false;
+                    seen.add(r.url);
+                    return true;
+                });
+                return {
+                    searchResults: searchResults.slice(0, maxResults),
+                    currentPhase: "searching",
+                    // Preserve original subject on first search
+                    originalSubject: originalSubject ?? subject,
+                };
+            }
+            catch (err) {
+                // Degraded mode: return empty results with error instead of throwing
+                logError("Search failed, entering degraded mode", {
+                    node: "searcher",
+                    researchId: subject,
+                    traceId,
+                    errorCode: ErrorCodes.SEARCH_FAILED,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                return {
+                    searchResults: [],
+                    error: `Search failed: ${err instanceof Error ? err.message : String(err)}`,
+                    currentPhase: "searching",
+                    originalSubject: originalSubject ?? subject,
+                };
+            }
+        });
+    };
+    return node;
+}
+/**
+ * Evaluates relevance of search results and rewrites the query if needed.
+ * Loops back to searcher when relevance is low and rewrites are available.
+ */
+function queryRewriterNode(chatModel) {
+    const node = async (state) => {
+        const { subject, searchResults, traceId, rewriteCount } = state;
+        return withNodeTiming("queryRewriter", traceId, subject, async () => {
+            const result = await evaluateQueryRelevance(subject, searchResults, chatModel, traceId);
+            return {
+                relevanceScore: result.relevanceScore,
+                rewrittenQuery: result.isRelevant ? undefined : result.rewrittenQuery,
+                rewriteCount: result.isRelevant ? rewriteCount : rewriteCount + 1,
+                currentPhase: "queryRewriting",
+            };
+        });
+    };
+    return node;
+}
+/**
+ * Re-ranks search results by semantic similarity to the subject.
+ * Filters out low-relevance results before summarization.
+ */
+function rerankerNode(embeddings) {
+    const node = async (state) => {
+        const { subject, searchResults, traceId } = state;
+        return withNodeTiming("reranker", traceId, subject, async () => {
+            const ranked = await rerankSearchResults(subject, searchResults, embeddings, { topN: 10 }, traceId);
+            return {
+                searchResults: ranked.map((r) => r.result),
+                currentPhase: "reranking",
+            };
+        });
+    };
+    return node;
+}
+function summarizerNode(chatModel) {
+    const node = async (state) => {
+        const { subject, searchResults, traceId } = state;
+        return withNodeTiming("summarizer", traceId, subject, async () => {
+            try {
+                logInfo("Summarizing", { node: "summarizer", researchId: subject, traceId });
+                const summarization = await summarizeSearchResults(subject, searchResults, chatModel);
+                // Synthesis step: produce a unified research report from per-source takeaways
+                try {
+                    const synthesis = await synthesizeSummary(subject, summarization.sourceSummaries, chatModel);
+                    summarization.synthesizedSummary = synthesis.synthesizedSummary;
+                    summarization.keyFindings = synthesis.keyFindings;
+                    summarization.limitations = synthesis.limitations;
+                    logInfo("Synthesis complete", {
+                        node: "summarizer",
+                        researchId: subject,
+                        traceId,
+                        summaryLength: synthesis.synthesizedSummary.length,
+                        keyFindingsCount: synthesis.keyFindings.length,
+                    });
+                }
+                catch (synthErr) {
+                    // Synthesis is non-fatal — fall back to composite summary
+                    logWarn("Synthesis failed, using per-source composite summary", {
+                        node: "summarizer",
+                        researchId: subject,
+                        traceId,
+                        error: synthErr instanceof Error ? synthErr.message : String(synthErr),
+                    });
+                }
+                // Token usage is captured automatically via the TokenUsageCollector
+                // callback wired at graph construction (chatModel.withConfig({ callbacks })).
+                // LangChain fires handleLLMEnd at the LLM layer before withStructuredOutput
+                // post-processing, so token counts accumulate correctly.
+                return {
+                    summarization,
+                    currentPhase: "summarizing",
+                };
+            }
+            catch (err) {
+                // Degraded mode: persist raw results without summarization
+                logError("Summarization failed, persisting raw results", {
+                    node: "summarizer",
+                    researchId: subject,
+                    traceId,
+                    errorCode: ErrorCodes.SUMMARIZATION_FAILED,
+                    error: err instanceof Error ? err.message : String(err),
+                });
+                return {
+                    summarization: {
+                        sourceSummaries: searchResults.map((r) => ({
+                            url: r.url,
+                            title: r.title,
+                            keyTakeaways: r.snippet,
+                            relevance: 0.1,
+                            tags: [],
+                            language: "en",
+                        })),
+                        overallConfidence: 0.1,
+                        tags: [],
+                        language: "en",
+                        extractionBreakdown: [],
+                    },
+                    currentPhase: "summarizing",
+                };
+            }
+        });
+    };
+    return node;
+}
+function persisterNode(deps) {
+    const node = async (state) => {
+        const { subject, traceId, cachedResearch, searchResults, summarization, error, tenantId, metadata, plannedQueries, } = state;
+        return withNodeTiming("persister", traceId, subject, async () => {
+            // If error occurred upstream, skip persistence
+            if (error) {
+                logError("Skipping persistence due to upstream error", {
+                    node: "persister",
+                    researchId: subject,
+                    error,
+                });
+                return { currentPhase: "persisting" };
+            }
+            // If returning cached result (isFresh path), just set source
+            if (!summarization) {
+                if (deps.onCacheHit && cachedResearch) {
+                    try {
+                        await deps.onCacheHit(cachedResearch);
+                    }
+                    catch {
+                        /* non-fatal: consumer hook */
+                    }
+                }
+                return {
+                    research: cachedResearch,
+                    source: "cache",
+                    currentPhase: "persisting",
+                    tokenUsage: deps.tokenCollector?.usage ?? { promptTokens: 0, completionTokens: 0 },
+                };
+            }
+            // Delete stale entry before inserting new one
+            if (cachedResearch) {
+                await deps.researchRepository.deleteByIds([cachedResearch.id]);
+            }
+            const freshnessDays = deps.freshnessDays ?? state.freshnessDays;
+            // Filter out dead sources (relevance === 0 or empty URL)
+            const cleanSummaries = summarization.sourceSummaries.filter((s) => s.url.length > 0 && s.relevance > 0);
+            // Use synthesis if available and substantial; otherwise fall back to composite
+            const synthesisText = summarization.synthesizedSummary?.trim();
+            const MIN_SYNTHESIS_LENGTH = 200;
+            const summary = synthesisText && synthesisText.length >= MIN_SYNTHESIS_LENGTH
+                ? synthesisText
+                : buildCompositeSummary(cleanSummaries);
+            // Use planned queries (if available) instead of just the subject
+            const storedQueries = plannedQueries.length > 0 ? [...new Set([subject, ...plannedQueries])] : [subject];
+            const research = buildResearch({
+                subject,
+                sourceSummaries: cleanSummaries,
+                summary,
+                sourceUrls: searchResults.map((r) => r.url).filter(Boolean),
+                searchQueries: storedQueries,
+                confidenceScore: summarization.overallConfidence,
+                tags: summarization.tags,
+                language: summarization.language,
+                rawResultCount: searchResults.length,
+                keyFindings: summarization.keyFindings,
+                limitations: summarization.limitations,
+                tenantId,
+                metadata,
+                freshnessDays,
+            });
+            await deps.researchRepository.upsert(research);
+            if (deps.onResearchComplete) {
+                try {
+                    await deps.onResearchComplete(research);
+                }
+                catch {
+                    /* non-fatal: consumer hook */
+                }
+            }
+            logInfo("Research persisted", { node: "persister", researchId: research.id, traceId });
+            return {
+                research,
+                source: cachedResearch ? "cache+web" : "web",
+                currentPhase: "persisting",
+                tokenUsage: deps.tokenCollector?.usage ?? { promptTokens: 0, completionTokens: 0 },
+            };
+        });
+    };
+    return node;
+}
+/** Emits a LangGraph interrupt payload for external systems to approve/resume. */
+function humanApprovalNode(deps, checkpointer) {
+    const node = async (state) => {
+        const { subject, searchResults, traceId, summarization } = state;
+        return withNodeTiming("human_approval", traceId, subject, async () => {
+            if (deps.onApprovalRequired) {
+                const confidence = summarization?.overallConfidence ?? 0;
+                try {
+                    await deps.onApprovalRequired(subject, confidence);
+                }
+                catch {
+                    /* non-fatal: consumer hook */
+                }
+            }
+            if (checkpointer instanceof MemorySaver) {
+                logWarn("HITL interrupt issued with in-memory checkpointer (MemorySaver). " +
+                    "State will be lost on process restart — HITL resume will fail. " +
+                    "Set RMS_CHECKPOINTER=sqlite or inject a durable checkpointer.", { node: "human_approval", subject, traceId });
+            }
+            interrupt({
+                action: "approve_research",
+                subject,
+                resultCount: searchResults.length,
+                message: "Please approve this research before persistence.",
+            });
+            return {};
+        });
+    };
+    return node;
+}
+// ── Conditional Edge Routers ─────────────────────────────────────────
+/** Route to guardrail when cache is stale/missing; otherwise skip to persister. */
+const routeAfterFreshness = (state) => {
+    if (state.isFresh && !state.forceRefresh && state.cachedResearch)
+        return "persister";
+    return "guardrail";
+};
+/** Route to queryPlanner if guardrail allows; otherwise to persister (blocked). */
+const routeAfterGuardrail = (state) => {
+    if (state.error)
+        return "persister";
+    return "queryPlanner";
+};
+/**
+ * Route after query relevance evaluation:
+ * - If relevant OR max rewrites reached → reranker
+ * - If irrelevant and rewrites left → searcher (with rewritten query)
+ */
+const routeAfterQueryRewriter = (state) => {
+    if (state.rewrittenQuery && state.rewriteCount <= MAX_REWRITES)
+        return "searcher";
+    return "reranker";
+};
+/** Confidence gating: low-confidence summaries (< 0.4) route to human approval for review. */
+const routeAfterSummarizer = (state) => {
+    const score = state.summarization?.overallConfidence ?? 1;
+    if (score < 0.4)
+        return "human_approval";
+    return "persister";
+};
+//# sourceMappingURL=workflow.js.map

package/dist/app/graph/workflow.js.map

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

package/dist/app/queryPlanning/planner.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod/v4";
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+/**
+ * Schema for the LLM structured output when planning search queries.
+ */
+export declare const QueryPlanOutputSchema: z.ZodObject<{
+    queries: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type QueryPlanOutput = z.infer<typeof QueryPlanOutputSchema>;
+/**
+ * Generates optimized search queries from a natural language research subject.
+ *
+ * Converts conversational or vague subjects into 2-4 diverse keyword queries
+ * that are optimized for web search engines (SearXNG). This dramatically
+ * improves search result quality compared to passing raw subjects as queries.
+ */
+export declare function planSearchQueries(subject: string, chatModel: BaseChatModel, traceId?: string): Promise<string[]>;
+//# sourceMappingURL=planner.d.ts.map

package/dist/app/queryPlanning/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/app/queryPlanning/planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAIjF;;GAEG;AACH,eAAO,MAAM,qBAAqB;;iBAehC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAgBpE;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CA2CnB"}

package/dist/app/queryPlanning/planner.js

@@ -0,0 +1,80 @@
+import { z } from "zod/v4";
+import { HumanMessage, SystemMessage } from "@langchain/core/messages";
+import { logInfo, logWarn, withNodeTiming } from "../../infra/observability/tracing.js";
+/**
+ * Schema for the LLM structured output when planning search queries.
+ */
+export const QueryPlanOutputSchema = z.object({
+    queries: z
+        .array(z.string())
+        .min(1)
+        .max(4)
+        .meta({
+        description: "2-4 diverse, optimized keyword search queries designed to retrieve the best web results " +
+            "for the given research subject. Each query should approach the topic from a different angle: " +
+            "one broad, one specific/technical, and optionally one using alternative terminology.",
+        examples: [
+            ["LangGraph state management best practices", "LangGraph StateGraph TypeScript tutorial"],
+            ["React server components vs client components", "Next.js RSC architecture 2025"],
+        ],
+    }),
+});
+const SYSTEM_PROMPT = `You are a search query optimization expert. Your queries feed into SearXNG for an automated research pipeline.
+
+Before generating, consider: what sub-topics exist, and what alternative terminology could improve coverage?
+
+Guidelines:
+1. Generate 2-4 keyword-focused search queries optimized for web search engines.
+2. Use specific keywords with technical terms, version numbers, or product names when relevant.
+3. Cover different angles: broad overview, specific/technical, and alternative terminology.
+4. Prefer queries that return documentation, tutorials, or authoritative sources.
+
+Example — subject: "How to handle state in LangGraph"
+  Good: "LangGraph StateGraph state management best practices", "LangGraph TypeScript checkpointer persistence tutorial 2025"
+  Bad (just rephrasing): "how to handle state in LangGraph"`;
+/**
+ * Generates optimized search queries from a natural language research subject.
+ *
+ * Converts conversational or vague subjects into 2-4 diverse keyword queries
+ * that are optimized for web search engines (SearXNG). This dramatically
+ * improves search result quality compared to passing raw subjects as queries.
+ */
+export async function planSearchQueries(subject, chatModel, traceId) {
+    return withNodeTiming("queryPlanner", traceId, subject, async () => {
+        logInfo("Planning search queries", {
+            node: "queryPlanner",
+            traceId,
+            researchId: subject,
+        });
+        const humanMsg = `Research subject:\n<subject>\n${subject}\n</subject>\n\n` +
+            `Generate 2-4 optimized search queries for this research subject.`;
+        try {
+            const structuredModel = chatModel.withStructuredOutput(QueryPlanOutputSchema, {
+                method: "jsonSchema",
+                name: "query_plan",
+            });
+            const result = await structuredModel.invoke([
+                new SystemMessage(SYSTEM_PROMPT),
+                new HumanMessage(humanMsg),
+            ]);
+            const queries = result.queries.map((q) => q.trim()).filter((q) => q.length > 0);
+            logInfo("Search queries planned", {
+                node: "queryPlanner",
+                traceId,
+                researchId: subject,
+                queryCount: queries.length,
+            });
+            return queries.length > 0 ? queries : [subject];
+        }
+        catch (err) {
+            // On failure, fall back to using the raw subject as the search query
+            logWarn("Query planning failed, using raw subject", {
+                node: "queryPlanner",
+                traceId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return [subject];
+        }
+    });
+}
+//# sourceMappingURL=planner.js.map

package/dist/app/queryPlanning/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../../src/app/queryPlanning/planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAExF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,CAAC,CAAC;SACN,IAAI,CAAC;QACJ,WAAW,EACT,0FAA0F;YAC1F,+FAA+F;YAC/F,sFAAsF;QACxF,QAAQ,EAAE;YACR,CAAC,2CAA2C,EAAE,0CAA0C,CAAC;YACzF,CAAC,8CAA8C,EAAE,+BAA+B,CAAC;SAClF;KACF,CAAC;CACL,CAAC,CAAC;AAIH,MAAM,aAAa,GAAG;;;;;;;;;;;;4DAYsC,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAe,EACf,SAAwB,EACxB,OAAgB;IAEhB,OAAO,cAAc,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE;QACjE,OAAO,CAAC,yBAAyB,EAAE;YACjC,IAAI,EAAE,cAAc;YACpB,OAAO;YACP,UAAU,EAAE,OAAO;SACpB,CAAC,CAAC;QAEH,MAAM,QAAQ,GACZ,iCAAiC,OAAO,kBAAkB;YAC1D,kEAAkE,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,SAAS,CAAC,oBAAoB,CAAC,qBAAqB,EAAE;gBAC5E,MAAM,EAAE,YAAY;gBACpB,IAAI,EAAE,YAAY;aACnB,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC;gBAC1C,IAAI,aAAa,CAAC,aAAa,CAAC;gBAChC,IAAI,YAAY,CAAC,QAAQ,CAAC;aAC3B,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAEhF,OAAO,CAAC,wBAAwB,EAAE;gBAChC,IAAI,EAAE,cAAc;gBACpB,OAAO;gBACP,UAAU,EAAE,OAAO;gBACnB,UAAU,EAAE,OAAO,CAAC,MAAM;aAC3B,CAAC,CAAC;YAEH,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,qEAAqE;YACrE,OAAO,CAAC,0CAA0C,EAAE;gBAClD,IAAI,EAAE,cAAc;gBACpB,OAAO;gBACP,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC,CAAC;YACH,OAAO,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/app/queryRewriting/rewriter.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod/v4";
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import type { SearxngSearchResult } from "../../infra/search/searxngClient.js";
+/** Maximum number of query rewrites before forcing summarization. */
+export declare const MAX_REWRITES = 2;
+/** Minimum relevance score below which a rewrite is triggered. */
+export declare const MIN_RELEVANCE_SCORE = 0.4;
+/**
+ * Schema for the LLM structured output when evaluating query relevance.
+ */
+export declare const QueryRewriteOutputSchema: z.ZodObject<{
+    isRelevant: z.ZodBoolean;
+    relevanceScore: z.ZodDefault<z.ZodNumber>;
+    rewrittenQuery: z.ZodOptional<z.ZodString>;
+    reasoning: z.ZodString;
+}, z.core.$strip>;
+export type QueryRewriteOutput = z.infer<typeof QueryRewriteOutputSchema>;
+export interface QueryRewriteResult {
+    isRelevant: boolean;
+    relevanceScore: number;
+    rewrittenQuery?: string | undefined;
+    reasoning: string;
+}
+/**
+ * Evaluates the relevance of search results to the subject and optionally
+ * rewrites the query for better results.
+ *
+ * Used as a feedback loop node in the LangGraph workflow:
+ * searcher → queryRewriter → (relevant? summarizer : searcher with rewritten query)
+ */
+export declare function evaluateQueryRelevance(subject: string, searchResults: SearxngSearchResult[], chatModel: BaseChatModel, traceId?: string): Promise<QueryRewriteResult>;
+//# sourceMappingURL=rewriter.d.ts.map

package/dist/app/queryRewriting/rewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewriter.d.ts","sourceRoot":"","sources":["../../../src/app/queryRewriting/rewriter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAG/E,qEAAqE;AACrE,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,kEAAkE;AAClE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;iBAgCnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAe1E,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,mBAAmB,EAAE,EACpC,SAAS,EAAE,aAAa,EACxB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAyD7B"}