@farukada/langchain-ts-rms 0.1.0

package/dist/app/queryRewriting/rewriter.js

@@ -0,0 +1,111 @@
+import { z } from "zod/v4";
+import { HumanMessage, SystemMessage } from "@langchain/core/messages";
+import { logInfo, logDebug, logWarn, withNodeTiming } from "../../infra/observability/tracing.js";
+/** Maximum number of query rewrites before forcing summarization. */
+export const MAX_REWRITES = 2;
+/** Minimum relevance score below which a rewrite is triggered. */
+export const MIN_RELEVANCE_SCORE = 0.4;
+/**
+ * Schema for the LLM structured output when evaluating query relevance.
+ */
+export const QueryRewriteOutputSchema = z.object({
+    isRelevant: z.boolean().meta({
+        description: "Whether the search results are sufficiently relevant to the research subject. " +
+            "True if the results contain substantial information addressing the subject. " +
+            "False if the results are mostly irrelevant, off-topic, or too sparse.",
+    }),
+    relevanceScore: z
+        .number()
+        .min(0)
+        .max(1)
+        .default(0.5)
+        .meta({
+        description: "A score from 0.0 to 1.0 indicating how relevant the search results are to the subject. " +
+            "0.0 = completely irrelevant, 1.0 = perfectly relevant.",
+        examples: [0.2, 0.5, 0.8],
+    }),
+    rewrittenQuery: z
+        .string()
+        .optional()
+        .meta({
+        description: "If the results are not relevant, provide a rewritten version of the search query " +
+            "that might produce better results. Use more specific terms, add context, or rephrase. " +
+            "Only set this if isRelevant is false.",
+    }),
+    reasoning: z.string().meta({
+        description: "Brief explanation of why the results are or are not relevant, " +
+            "and what the rewritten query aims to improve.",
+    }),
+});
+const SYSTEM_PROMPT = `You are a search quality evaluator in an automated research pipeline. Your assessment determines whether to proceed or retry with a better query.
+
+Before scoring, consider: do results directly address the subject, and are the sources substantive?
+
+Guidelines:
+1. Assess whether results directly address the research subject.
+2. Consider both coverage (breadth) and quality (source reliability, depth).
+3. If insufficient, provide a rewritten query with more specific or clarifying terms.
+4. Score based on actual content quality, not surface-level keyword matches.
+
+Example — Subject: "Rust async runtime comparison", results mostly about Rust basics
+  → relevanceScore: 0.15, rewrittenQuery: "tokio vs async-std vs smol Rust async runtime benchmark 2025"`;
+/**
+ * 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 async function evaluateQueryRelevance(subject, searchResults, chatModel, traceId) {
+    return withNodeTiming("queryRewriter", traceId, subject, async () => {
+        logDebug("Evaluating search result relevance", {
+            node: "queryRewriter",
+            traceId,
+            researchId: subject,
+        });
+        const resultsPreview = searchResults
+            .slice(0, 5) // Only send top-5 to reduce tokens
+            .map((r, i) => `[${String(i + 1)}] ${r.title}\n${r.snippet}`)
+            .join("\n\n");
+        const humanMsg = `Research subject:\n<subject>\n${subject}\n</subject>\n\n` +
+            `Search results (${String(searchResults.length)} total, showing top 5):\n<search_results>\n${resultsPreview}\n</search_results>\n\n` +
+            `Evaluate the relevance of these results to the research subject.`;
+        try {
+            const structuredModel = chatModel.withStructuredOutput(QueryRewriteOutputSchema, {
+                method: "jsonSchema",
+                name: "query_relevance_evaluation",
+            });
+            const result = await structuredModel.invoke([
+                new SystemMessage(SYSTEM_PROMPT),
+                new HumanMessage(humanMsg),
+            ]);
+            const relevanceScore = Math.min(1, Math.max(0, result.relevanceScore ?? 0.5));
+            const isRelevant = result.isRelevant && relevanceScore >= MIN_RELEVANCE_SCORE;
+            logInfo("Query relevance evaluated", {
+                node: "queryRewriter",
+                traceId,
+                researchId: subject,
+            });
+            return {
+                isRelevant,
+                relevanceScore,
+                rewrittenQuery: isRelevant ? undefined : result.rewrittenQuery,
+                reasoning: result.reasoning,
+            };
+        }
+        catch (err) {
+            // On evaluation failure, assume results are relevant to avoid blocking
+            logWarn("Query relevance evaluation failed, assuming relevant", {
+                node: "queryRewriter",
+                traceId,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return {
+                isRelevant: true,
+                relevanceScore: 0.5,
+                reasoning: "Evaluation failed; proceeding with current results.",
+            };
+        }
+    });
+}
+//# sourceMappingURL=rewriter.js.map

package/dist/app/queryRewriting/rewriter.js.map

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

package/dist/app/reranking/reranker.d.ts

@@ -0,0 +1,27 @@
+import type { EmbeddingsInterface } from "@langchain/core/embeddings";
+import type { SearxngSearchResult } from "../../infra/search/searxngClient.js";
+export interface RerankOptions {
+    /** Minimum cosine similarity score to keep a result. Defaults to 0.3. */
+    minScore?: number;
+    /** Maximum number of results to return after re-ranking. Defaults to input length. */
+    topN?: number;
+}
+export interface RankedResult {
+    result: SearxngSearchResult;
+    score: number;
+}
+/**
+ * Cosine similarity between two vectors.
+ */
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Re-ranks search results by embedding-based semantic similarity to the subject.
+ *
+ * 1. Embeds the subject and each result snippet
+ * 2. Computes cosine similarity between subject and each snippet
+ * 3. Filters out results below `minScore`
+ * 4. Sorts by descending similarity
+ * 5. Returns top-N results
+ */
+export declare function rerankSearchResults(subject: string, results: SearxngSearchResult[], embeddings: EmbeddingsInterface, options?: RerankOptions, traceId?: string): Promise<RankedResult[]>;
+//# sourceMappingURL=reranker.d.ts.map

package/dist/app/reranking/reranker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reranker.d.ts","sourceRoot":"","sources":["../../../src/app/reranking/reranker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAG/E,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sFAAsF;IACtF,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAWjE;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,mBAAmB,EAAE,EAC9B,UAAU,EAAE,mBAAmB,EAC/B,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC,CA8CzB"}

package/dist/app/reranking/reranker.js

@@ -0,0 +1,67 @@
+import { logInfo, logDebug, withNodeTiming } from "../../infra/observability/tracing.js";
+/**
+ * Cosine similarity between two vectors.
+ */
+export function cosineSimilarity(a, b) {
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += (a[i] ?? 0) * (b[i] ?? 0);
+        normA += (a[i] ?? 0) ** 2;
+        normB += (b[i] ?? 0) ** 2;
+    }
+    const denom = Math.sqrt(normA) * Math.sqrt(normB);
+    return denom === 0 ? 0 : dot / denom;
+}
+/**
+ * Re-ranks search results by embedding-based semantic similarity to the subject.
+ *
+ * 1. Embeds the subject and each result snippet
+ * 2. Computes cosine similarity between subject and each snippet
+ * 3. Filters out results below `minScore`
+ * 4. Sorts by descending similarity
+ * 5. Returns top-N results
+ */
+export async function rerankSearchResults(subject, results, embeddings, options, traceId) {
+    if (results.length === 0)
+        return [];
+    const minScore = options?.minScore ?? 0;
+    const topN = options?.topN ?? results.length;
+    return withNodeTiming("reranker", traceId, subject, async () => {
+        // Build texts for embedding: subject + each snippet
+        const snippets = results.map((r) => `${r.title}\n${r.snippet}`);
+        const allTexts = [subject, ...snippets];
+        logDebug("Embedding for re-ranking", {
+            node: "reranker",
+            traceId,
+            researchId: subject,
+        });
+        const vectors = await embeddings.embedDocuments(allTexts);
+        const subjectVector = vectors[0];
+        if (!subjectVector) {
+            return results.map((r) => ({ result: r, score: 0 }));
+        }
+        // Score each result
+        const scored = [];
+        for (let i = 0; i < results.length; i++) {
+            const resultVector = vectors[i + 1];
+            if (!resultVector)
+                continue;
+            const score = cosineSimilarity(subjectVector, resultVector);
+            if (score >= minScore) {
+                scored.push({ result: results[i], score });
+            }
+        }
+        // Sort descending by score
+        scored.sort((a, b) => b.score - a.score);
+        const ranked = scored.slice(0, topN);
+        logInfo("Re-ranking complete", {
+            node: "reranker",
+            traceId,
+            researchId: subject,
+        });
+        return ranked;
+    });
+}
+//# sourceMappingURL=reranker.js.map

package/dist/app/reranking/reranker.js.map

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

package/dist/app/state/schema.d.ts

@@ -0,0 +1,121 @@
+import type { SearxngSearchResult } from "../../infra/search/searxngClient.js";
+import type { SummarizationResult } from "../summarization/summarizer.js";
+export type RmsPhase = "freshness" | "queryPlanning" | "searching" | "queryRewriting" | "reranking" | "summarizing" | "persisting";
+/**
+ * LangGraph state definition — shared across freshnessChecker, searcher,
+ * summarizer, and persister nodes.
+ *
+ * Uses `Annotation.Root` (same pattern as GMS) for typed graph state
+ * with reducers and defaults.
+ *
+ * @see GMS's `GmsStateAnnotation` in `src/app/state/schema.ts`
+ */
+export declare const RmsStateAnnotation: import("@langchain/langgraph").AnnotationRoot<{
+    /** The research subject/query being investigated. */
+    subject: import("@langchain/langgraph").LastValue<string>;
+    /** Optional tenant isolation ID. */
+    tenantId: import("@langchain/langgraph").LastValue<string | undefined>;
+    /** Whether to bypass cache and force a fresh search. */
+    forceRefresh: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /** Maximum number of search results to retrieve. */
+    maxResults: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+    /** Freshness threshold in days. */
+    freshnessDays: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+    /** Cached research if found (populated by freshnessChecker). */
+    cachedResearch: import("@langchain/langgraph").LastValue<{
+        id: string;
+        subject: string;
+        summary: string;
+        sourceSummaries: {
+            url: string;
+            title: string;
+            keyTakeaways: string;
+            relevance: number;
+            tags: string[];
+            language: string;
+        }[];
+        sourceUrls: string[];
+        searchQueries: string[];
+        status: "active" | "stale" | "refreshing" | "archived" | "low_confidence";
+        confidenceScore: number;
+        sourceCount: number;
+        tags: string[];
+        language: string;
+        rawResultCount: number;
+        metadata: Record<string, unknown>;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        expiresAt?: string | undefined;
+        tenantId?: string | undefined;
+        keyFindings?: string[] | undefined;
+        limitations?: string[] | undefined;
+    } | undefined>;
+    /** Whether cached research is still fresh. */
+    isFresh: import("@langchain/langgraph").BaseChannel<boolean, boolean | import("@langchain/langgraph").OverwriteValue<boolean>, unknown>;
+    /** Raw search results from SearXNG. */
+    searchResults: import("@langchain/langgraph").BaseChannel<SearxngSearchResult[], SearxngSearchResult[] | import("@langchain/langgraph").OverwriteValue<SearxngSearchResult[]>, unknown>;
+    /** LLM summarization output. */
+    summarization: import("@langchain/langgraph").LastValue<SummarizationResult | undefined>;
+    /** Final persisted research entry. */
+    research: import("@langchain/langgraph").LastValue<{
+        id: string;
+        subject: string;
+        summary: string;
+        sourceSummaries: {
+            url: string;
+            title: string;
+            keyTakeaways: string;
+            relevance: number;
+            tags: string[];
+            language: string;
+        }[];
+        sourceUrls: string[];
+        searchQueries: string[];
+        status: "active" | "stale" | "refreshing" | "archived" | "low_confidence";
+        confidenceScore: number;
+        sourceCount: number;
+        tags: string[];
+        language: string;
+        rawResultCount: number;
+        metadata: Record<string, unknown>;
+        createdAt?: string | undefined;
+        updatedAt?: string | undefined;
+        expiresAt?: string | undefined;
+        tenantId?: string | undefined;
+        keyFindings?: string[] | undefined;
+        limitations?: string[] | undefined;
+    } | undefined>;
+    /** Source of the result: cache, web, or cache+web (refreshed). */
+    source: import("@langchain/langgraph").BaseChannel<"cache" | "web" | "cache+web", "cache" | "web" | "cache+web" | import("@langchain/langgraph").OverwriteValue<"cache" | "web" | "cache+web">, unknown>;
+    /** Current workflow phase. */
+    currentPhase: import("@langchain/langgraph").BaseChannel<RmsPhase, RmsPhase | import("@langchain/langgraph").OverwriteValue<RmsPhase>, unknown>;
+    /** Error message if any node fails. */
+    error: import("@langchain/langgraph").LastValue<string | undefined>;
+    /** Distributed trace ID for observability. */
+    traceId: import("@langchain/langgraph").LastValue<string | undefined>;
+    /** Optional metadata to attach to the research entry. */
+    metadata: import("@langchain/langgraph").LastValue<Record<string, unknown> | undefined>;
+    /** Number of query rewrites performed (agentic RAG loop). */
+    rewriteCount: import("@langchain/langgraph").BaseChannel<number, number | import("@langchain/langgraph").OverwriteValue<number>, unknown>;
+    /** The original subject before any query rewrites. */
+    originalSubject: import("@langchain/langgraph").LastValue<string | undefined>;
+    /** The rewritten query (set by queryRewriter when relevance is low). */
+    rewrittenQuery: import("@langchain/langgraph").LastValue<string | undefined>;
+    /** Search result relevance score from the query rewriter. */
+    relevanceScore: import("@langchain/langgraph").LastValue<number | undefined>;
+    /** Planned search queries generated by the query planner node. */
+    plannedQueries: import("@langchain/langgraph").BaseChannel<string[], string[] | import("@langchain/langgraph").OverwriteValue<string[]>, unknown>;
+    /** Accumulated token usage across all LLM calls (planner, rewriter, summarizer). */
+    tokenUsage: import("@langchain/langgraph").BaseChannel<{
+        promptTokens: number;
+        completionTokens: number;
+    }, {
+        promptTokens: number;
+        completionTokens: number;
+    } | import("@langchain/langgraph").OverwriteValue<{
+        promptTokens: number;
+        completionTokens: number;
+    }>, unknown>;
+}>;
+export type RmsState = typeof RmsStateAnnotation.State;
+//# sourceMappingURL=schema.d.ts.map

package/dist/app/state/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/app/state/schema.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAE1E,MAAM,MAAM,QAAQ,GAChB,WAAW,GACX,eAAe,GACf,WAAW,GACX,gBAAgB,GAChB,WAAW,GACX,aAAa,GACb,YAAY,CAAC;AAEjB;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB;IAC7B,qDAAqD;;IAErD,oCAAoC;;IAEpC,wDAAwD;;IAKxD,oDAAoD;;IAKpD,mCAAmC;;IAKnC,gEAAgE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEhE,8CAA8C;;IAK9C,uCAAuC;;IAKvC,gCAAgC;;IAEhC,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAEtC,kEAAkE;;IAKlE,8BAA8B;;IAK9B,uCAAuC;;IAEvC,8CAA8C;;IAE9C,yDAAyD;;IAEzD,6DAA6D;;IAK7D,sDAAsD;;IAEtD,wEAAwE;;IAExE,6DAA6D;;IAE7D,kEAAkE;;IAMlE,oFAAoF;;sBAC7C,MAAM;0BAAoB,MAAM;;sBAAhC,MAAM;0BAAoB,MAAM;;sBAAhC,MAAM;0BAAoB,MAAM;;EAOvE,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,kBAAkB,CAAC,KAAK,CAAC"}

package/dist/app/state/schema.js

@@ -0,0 +1,88 @@
+import { Annotation } from "@langchain/langgraph";
+/**
+ * LangGraph state definition — shared across freshnessChecker, searcher,
+ * summarizer, and persister nodes.
+ *
+ * Uses `Annotation.Root` (same pattern as GMS) for typed graph state
+ * with reducers and defaults.
+ *
+ * @see GMS's `GmsStateAnnotation` in `src/app/state/schema.ts`
+ */
+export const RmsStateAnnotation = Annotation.Root({
+    /** The research subject/query being investigated. */
+    subject: Annotation(),
+    /** Optional tenant isolation ID. */
+    tenantId: Annotation(),
+    /** Whether to bypass cache and force a fresh search. */
+    forceRefresh: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => false,
+    }),
+    /** Maximum number of search results to retrieve. */
+    maxResults: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => 10,
+    }),
+    /** Freshness threshold in days. */
+    freshnessDays: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => 7,
+    }),
+    /** Cached research if found (populated by freshnessChecker). */
+    cachedResearch: Annotation(),
+    /** Whether cached research is still fresh. */
+    isFresh: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => false,
+    }),
+    /** Raw search results from SearXNG. */
+    searchResults: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => [],
+    }),
+    /** LLM summarization output. */
+    summarization: Annotation(),
+    /** Final persisted research entry. */
+    research: Annotation(),
+    /** Source of the result: cache, web, or cache+web (refreshed). */
+    source: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => "web",
+    }),
+    /** Current workflow phase. */
+    currentPhase: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => "freshness",
+    }),
+    /** Error message if any node fails. */
+    error: Annotation(),
+    /** Distributed trace ID for observability. */
+    traceId: Annotation(),
+    /** Optional metadata to attach to the research entry. */
+    metadata: Annotation(),
+    /** Number of query rewrites performed (agentic RAG loop). */
+    rewriteCount: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => 0,
+    }),
+    /** The original subject before any query rewrites. */
+    originalSubject: Annotation(),
+    /** The rewritten query (set by queryRewriter when relevance is low). */
+    rewrittenQuery: Annotation(),
+    /** Search result relevance score from the query rewriter. */
+    relevanceScore: Annotation(),
+    /** Planned search queries generated by the query planner node. */
+    plannedQueries: Annotation({
+        reducer: (_prev, next) => next,
+        default: () => [],
+    }),
+    /** Accumulated token usage across all LLM calls (planner, rewriter, summarizer). */
+    tokenUsage: Annotation({
+        reducer: (prev, next) => ({
+            promptTokens: prev.promptTokens + next.promptTokens,
+            completionTokens: prev.completionTokens + next.completionTokens,
+        }),
+        default: () => ({ promptTokens: 0, completionTokens: 0 }),
+    }),
+});
+//# sourceMappingURL=schema.js.map

package/dist/app/state/schema.js.map

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

package/dist/app/summarization/summarizationSchema.d.ts

@@ -0,0 +1,34 @@
+import { z } from "zod/v4";
+/**
+ * Schema for structured LLM output when summarizing ONE search result.
+ * Used with `chatModel.withStructuredOutput(SourceSummaryOutputSchema)`.
+ *
+ * Each search result gets its own LLM call with this schema,
+ * keeping the task focused and the context small for reliable extraction.
+ */
+export declare const SourceSummaryOutputSchema: z.ZodObject<{
+    keyTakeaways: z.ZodString;
+    relevance: z.ZodDefault<z.ZodNumber>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    language: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type SourceSummaryOutput = z.infer<typeof SourceSummaryOutputSchema>;
+/**
+ * Schema for batched structured LLM output when summarizing ALL search results
+ * in a single call. Each element in the `sources` array corresponds to one
+ * search result, in order.
+ *
+ * @deprecated No longer used internally — the summarizer now processes
+ * one source per LLM call using {@link SourceSummaryOutputSchema}.
+ * Kept for backward compatibility of the public export surface.
+ */
+export declare const BatchSummaryOutputSchema: z.ZodObject<{
+    sources: z.ZodArray<z.ZodObject<{
+        keyTakeaways: z.ZodString;
+        relevance: z.ZodDefault<z.ZodNumber>;
+        tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        language: z.ZodDefault<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BatchSummaryOutput = z.infer<typeof BatchSummaryOutputSchema>;
+//# sourceMappingURL=summarizationSchema.d.ts.map

package/dist/app/summarization/summarizationSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizationSchema.d.ts","sourceRoot":"","sources":["../../../src/app/summarization/summarizationSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB;;;;;iBA2CpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB;;;;;;;iBAMnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}

package/dist/app/summarization/summarizationSchema.js

@@ -0,0 +1,65 @@
+import { z } from "zod/v4";
+/**
+ * Schema for structured LLM output when summarizing ONE search result.
+ * Used with `chatModel.withStructuredOutput(SourceSummaryOutputSchema)`.
+ *
+ * Each search result gets its own LLM call with this schema,
+ * keeping the task focused and the context small for reliable extraction.
+ */
+export const SourceSummaryOutputSchema = z.object({
+    keyTakeaways: z
+        .string()
+        .min(300)
+        .meta({
+        description: "8-15 detailed sentences extracting the most important facts, techniques, and insights from this specific source. " +
+            "Be concrete — include names, version numbers, code patterns, configuration values, and actionable details. " +
+            "Each sentence MUST convey a distinct fact. Cover all noteworthy information in the source.",
+        examples: [
+            "LangGraph v0.2 introduced the StateGraph API which replaces the legacy MessageGraph for stateful agent orchestration. " +
+                "The checkpointer interface supports pluggable backends including MemorySaver for development and PostgresSaver for production persistence.",
+        ],
+    }),
+    relevance: z
+        .number()
+        .min(0)
+        .max(1)
+        .default(0.5)
+        .meta({
+        description: "How relevant this source is to the research subject. " +
+            "0.7-1.0: directly on topic. 0.4-0.7: partially relevant. 0.0-0.3: off-topic or irrelevant.",
+        examples: [0.3, 0.7, 0.95],
+    }),
+    tags: z
+        .array(z.string())
+        .default([])
+        .meta({
+        description: "1 to 3 topic tags extracted from this specific source. E.g. ['typescript', 'node-js'].",
+        examples: [
+            ["typescript", "best-practices"],
+            ["react", "hooks"],
+        ],
+    }),
+    language: z
+        .string()
+        .default("en")
+        .meta({
+        description: "ISO 639-1 language code of this source. E.g. 'en', 'de', 'nl'.",
+        examples: ["en", "de", "nl", "fr"],
+    }),
+});
+/**
+ * Schema for batched structured LLM output when summarizing ALL search results
+ * in a single call. Each element in the `sources` array corresponds to one
+ * search result, in order.
+ *
+ * @deprecated No longer used internally — the summarizer now processes
+ * one source per LLM call using {@link SourceSummaryOutputSchema}.
+ * Kept for backward compatibility of the public export surface.
+ */
+export const BatchSummaryOutputSchema = z.object({
+    sources: z.array(SourceSummaryOutputSchema).meta({
+        description: "An array of summaries, one per source in the order they were provided. " +
+            "Each element contains the key takeaways, relevance score, tags, and language for that source.",
+    }),
+});
+//# sourceMappingURL=summarizationSchema.js.map

package/dist/app/summarization/summarizationSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizationSchema.js","sourceRoot":"","sources":["../../../src/app/summarization/summarizationSchema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,CAAC;SACR,IAAI,CAAC;QACJ,WAAW,EACT,mHAAmH;YACnH,6GAA6G;YAC7G,4FAA4F;QAC9F,QAAQ,EAAE;YACR,wHAAwH;gBACtH,4IAA4I;SAC/I;KACF,CAAC;IACJ,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,CAAC,CAAC;SACN,OAAO,CAAC,GAAG,CAAC;SACZ,IAAI,CAAC;QACJ,WAAW,EACT,uDAAuD;YACvD,4FAA4F;QAC9F,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC;KAC3B,CAAC;IACJ,IAAI,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;SACjB,OAAO,CAAC,EAAE,CAAC;SACX,IAAI,CAAC;QACJ,WAAW,EACT,wFAAwF;QAC1F,QAAQ,EAAE;YACR,CAAC,YAAY,EAAE,gBAAgB,CAAC;YAChC,CAAC,OAAO,EAAE,OAAO,CAAC;SACnB;KACF,CAAC;IACJ,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,OAAO,CAAC,IAAI,CAAC;SACb,IAAI,CAAC;QACJ,WAAW,EAAE,gEAAgE;QAC7E,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;KACnC,CAAC;CACL,CAAC,CAAC;AAIH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC,IAAI,CAAC;QAC/C,WAAW,EACT,yEAAyE;YACzE,+FAA+F;KAClG,CAAC;CACH,CAAC,CAAC"}

package/dist/app/summarization/summarizer.d.ts

@@ -0,0 +1,51 @@
+import type { BaseChatModel } from "@langchain/core/language_models/chat_models";
+import type { SearxngSearchResult } from "../../infra/search/searxngClient.js";
+import type { ExtractionMethod } from "../../infra/content/contentExtractor.js";
+/** Per-source summary produced by the extraction step. */
+export interface SourceSummary {
+    url: string;
+    title: string;
+    keyTakeaways: string;
+    relevance: number;
+    tags: string[];
+    language: string;
+}
+/** Per-URL extraction detail for debugging and verification. */
+export interface ExtractionDetail {
+    url: string;
+    method: ExtractionMethod;
+    extractedLength: number;
+}
+/** Aggregate output from `summarizeSearchResults()`, optionally enriched with synthesis. */
+export interface SummarizationResult {
+    sourceSummaries: SourceSummary[];
+    overallConfidence: number;
+    tags: string[];
+    language: string;
+    /** Per-URL extraction method breakdown for debugging. */
+    extractionBreakdown: ExtractionDetail[];
+    /** Synthesized multi-paragraph summary (produced by the synthesis step). */
+    synthesizedSummary?: string | undefined;
+    /** Key findings distilled from the research (produced by the synthesis step). */
+    keyFindings?: string[] | undefined;
+    /** Known gaps or limitations (produced by the synthesis step). */
+    limitations?: string[] | undefined;
+}
+/**
+ * Normalizes tags: lowercase, replace spaces with hyphens, deduplicate, sort.
+ * Ensures consistent tag format across all sources.
+ */
+export declare function normalizeTags(tags: string[]): string[];
+/**
+ * Summarizes search results by making ONE focused LLM call per source.
+ *
+ * Each source gets full page content extracted (when available, via streaming
+ * with byte-limit protection) or falls back to SearXNG snippets. Content is
+ * truncated to {@link MAX_CHARS_PER_SOURCE} chars per source.
+ *
+ * Individual source failures are isolated — a failed LLM call for one source
+ * does not affect the others. Failed sources fall back to snippet-based
+ * degraded entries with `relevance: 0`.
+ */
+export declare function summarizeSearchResults(subject: string, searchResults: SearxngSearchResult[], chatModel: BaseChatModel): Promise<SummarizationResult>;
+//# sourceMappingURL=summarizer.d.ts.map

package/dist/app/summarization/summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarizer.d.ts","sourceRoot":"","sources":["../../../src/app/summarization/summarizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAEjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAI/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAIhF,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,4FAA4F;AAC5F,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,mBAAmB,EAAE,gBAAgB,EAAE,CAAC;IACxC,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACnC,kEAAkE;IAClE,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CACpC;AAID;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKtD;AA2HD;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,mBAAmB,EAAE,EACpC,SAAS,EAAE,aAAa,GACvB,OAAO,CAAC,mBAAmB,CAAC,CAuD9B"}