@absolutejs/absolute 0.19.0-beta.609 → 0.19.0-beta.610

package/dist/ai/index.js

@@ -349,21 +349,48 @@ var buildExcerpt = (text, maxLength = 160) => {
 };
 var selectPreferredExcerpt = (excerpts, sectionChunkCount) => {
   if (!excerpts) {
-    return "";
+    return {
+      excerpt: "",
+      mode: "chunk",
+      reason: "single_chunk"
+    };
   }
   const chunkExcerpt = excerpts.chunkExcerpt?.trim() ?? "";
   const windowExcerpt = excerpts.windowExcerpt?.trim() ?? "";
   const sectionExcerpt = excerpts.sectionExcerpt?.trim() ?? "";
   if (sectionChunkCount && sectionChunkCount > 1 && chunkExcerpt.length > 0 && chunkExcerpt.length < 72) {
     if (sectionChunkCount <= 3 && sectionExcerpt) {
-      return sectionExcerpt;
+      return {
+        excerpt: sectionExcerpt,
+        mode: "section",
+        reason: "section_small_enough"
+      };
     }
     if (windowExcerpt) {
-      return windowExcerpt;
+      return {
+        excerpt: windowExcerpt,
+        mode: "window",
+        reason: "section_too_large_use_window"
+      };
     }
+    return {
+      excerpt: chunkExcerpt,
+      mode: "chunk",
+      reason: "chunk_too_narrow"
+    };
   }
-  return chunkExcerpt || windowExcerpt || sectionExcerpt;
+  return {
+    excerpt: chunkExcerpt || windowExcerpt || sectionExcerpt,
+    mode: "chunk",
+    reason: (sectionChunkCount ?? 0) > 1 ? "chunk_too_narrow" : "single_chunk"
+  };
 };
+var buildExcerptModeCounts = (references) => references.reduce((counts, reference) => {
+  if (reference?.excerptSelection) {
+    counts[reference.excerptSelection.mode] += 1;
+  }
+  return counts;
+}, { chunk: 0, section: 0, window: 0 });
 var buildGroundingChunkExcerpts = (sources, activeChunkId) => {
   if (sources.length === 0) {
     return;
@@ -419,8 +446,9 @@ var buildGroundedAnswerCitationDetail = (reference) => ({
   contextLabel: reference.contextLabel,
   evidenceLabel: buildGroundingReferenceEvidenceLabel(reference),
   evidenceSummary: buildGroundingReferenceEvidenceSummary(reference),
-  excerpt: selectPreferredExcerpt(reference.excerpts, getContextNumber(reference.metadata?.sectionChunkCount)) || reference.excerpt,
+  excerpt: selectPreferredExcerpt(reference.excerpts, getContextNumber(reference.metadata?.sectionChunkCount)).excerpt || reference.excerpt,
   excerpts: reference.excerpts,
+  excerptSelection: reference.excerptSelection,
   label: reference.label,
   locatorLabel: reference.locatorLabel,
   number: reference.number,
@@ -437,11 +465,14 @@ var buildRAGCitations = (sources) => {
     const hasBetterExisting = existing !== undefined && existing.score >= source.score;
     if (hasBetterExisting)
       continue;
+    const excerpts = buildGroundingChunkExcerpts(sources, source.chunkId);
+    const excerptSelection = selectPreferredExcerpt(excerpts, getContextNumber(source.metadata?.sectionChunkCount));
     unique.set(key, {
       chunkId: source.chunkId,
       contextLabel: source.labels?.contextLabel ?? buildContextLabel(source.metadata),
-      excerpt: selectPreferredExcerpt(buildGroundingChunkExcerpts(sources, source.chunkId), getContextNumber(source.metadata?.sectionChunkCount)) || buildExcerpt(source.text),
-      excerpts: buildGroundingChunkExcerpts(sources, source.chunkId),
+      excerpt: excerptSelection.excerpt || buildExcerpt(source.text),
+      excerpts,
+      excerptSelection,
       key,
       label: buildSourceLabel(source),
       locatorLabel: source.labels?.locatorLabel ?? buildLocatorLabel(source.metadata, source.source, source.title),
@@ -462,6 +493,7 @@ var buildRAGCitations = (sources) => {
 };
 var buildRAGGroundedAnswer = (content, sources) => {
   const references = buildRAGGroundingReferences(sources);
+  const sectionSummaries = buildRAGGroundedAnswerSectionSummaries(references);
   const referenceMap = new Map(references.map((reference) => [reference.number, reference]));
   const parts = [];
   const ungroundedReferenceNumbers = new Set;
@@ -505,10 +537,14 @@ var buildRAGGroundedAnswer = (content, sources) => {
   return {
     content,
     coverage,
+    excerptModeCounts: buildExcerptModeCounts([
+      ...references,
+      ...sectionSummaries
+    ]),
     hasCitations,
     parts,
     references,
-    sectionSummaries: buildRAGGroundedAnswerSectionSummaries(references),
+    sectionSummaries,
     ungroundedReferenceNumbers: [...ungroundedReferenceNumbers].sort((left, right) => left - right)
   };
 };
@@ -527,8 +563,9 @@ var buildRAGGroundedAnswerSectionSummaries = (references) => {
         chunkIds: [reference.chunkId],
         contextLabel: reference.contextLabel,
         count: 1,
-        excerpt: selectPreferredExcerpt(excerpts, getContextNumber(reference.metadata?.sectionChunkCount)) || excerpts?.sectionExcerpt || reference.excerpt,
+        excerpt: selectPreferredExcerpt(excerpts, getContextNumber(reference.metadata?.sectionChunkCount)).excerpt || excerpts?.sectionExcerpt || reference.excerpt,
         excerpts,
+        excerptSelection: reference.excerptSelection,
         key,
         label: key,
         locatorLabel: reference.locatorLabel,
@@ -564,6 +601,9 @@ var buildRAGGroundedAnswerSectionSummaries = (references) => {
       };
       existing.excerpt = reference.excerpts.sectionExcerpt;
     }
+    if (!existing.excerptSelection && reference.excerptSelection) {
+      existing.excerptSelection = reference.excerptSelection;
+    }
   }
   return [...groups.values()].map((group) => ({
     ...group,
@@ -583,11 +623,13 @@ var buildRAGGroundingReferences = (sources) => {
   const citationReferenceMap = buildRAGCitationReferenceMap(citations);
   return citations.map((citation) => {
     const excerpts = buildGroundingChunkExcerpts(sources, citation.chunkId);
+    const excerptSelection = selectPreferredExcerpt(excerpts, getContextNumber(citation.metadata?.sectionChunkCount));
     return {
       chunkId: citation.chunkId,
       contextLabel: citation.contextLabel ?? buildContextLabel(citation.metadata),
-      excerpt: selectPreferredExcerpt(excerpts, getContextNumber(citation.metadata?.sectionChunkCount)) || excerpts?.chunkExcerpt || buildExcerpt(citation.text),
+      excerpt: excerptSelection.excerpt || excerpts?.chunkExcerpt || buildExcerpt(citation.text),
       excerpts,
+      excerptSelection,
       label: citation.label,
       locatorLabel: citation.locatorLabel ?? buildLocatorLabel(citation.metadata, citation.source, citation.title),
       metadata: citation.metadata,
@@ -4317,22 +4359,49 @@ var buildRAGChunkExcerpts = (chunks, activeChunkId) => {
     windowExcerpt: buildExcerpt2(collectText(orderedWindowIds), 240)
   };
 };
-var buildRAGPreferredExcerpt = (excerpts, structure) => {
+var buildRAGExcerptSelection = (excerpts, structure) => {
   if (!excerpts) {
-    return "";
+    return {
+      excerpt: "",
+      mode: "chunk",
+      reason: "single_chunk"
+    };
   }
   const chunkLength = excerpts.chunkExcerpt.trim().length;
   const sectionChunkCount = structure?.sequence?.sectionChunkCount ?? 1;
   if (sectionChunkCount > 1 && chunkLength > 0 && chunkLength < 72) {
     if (sectionChunkCount <= 3 && excerpts.sectionExcerpt.trim().length > 0) {
-      return excerpts.sectionExcerpt;
+      return {
+        excerpt: excerpts.sectionExcerpt,
+        mode: "section",
+        reason: "section_small_enough"
+      };
     }
     if (excerpts.windowExcerpt.trim().length > 0) {
-      return excerpts.windowExcerpt;
+      return {
+        excerpt: excerpts.windowExcerpt,
+        mode: "window",
+        reason: "section_too_large_use_window"
+      };
     }
+    return {
+      excerpt: excerpts.chunkExcerpt,
+      mode: "chunk",
+      reason: "chunk_too_narrow"
+    };
   }
-  return excerpts.chunkExcerpt;
+  return {
+    excerpt: excerpts.chunkExcerpt,
+    mode: "chunk",
+    reason: sectionChunkCount > 1 ? "chunk_too_narrow" : "single_chunk"
+  };
 };
+var buildRAGExcerptModeCounts = (selections) => selections.reduce((counts, selection) => {
+  if (selection) {
+    counts[selection.mode] += 1;
+  }
+  return counts;
+}, { chunk: 0, section: 0, window: 0 });
 var buildRAGChunkGraph = (chunks) => {
   const nodes = [];
   const edges = [];
@@ -4521,19 +4590,27 @@ var buildRAGRetrievedState = (messages) => {
     return null;
   }
   const sources = message.sources ?? [];
+  const citations = buildRAGCitations(sources);
+  const sectionDiagnostics = buildRAGSectionRetrievalDiagnostics(sources, isRAGRetrievalTrace(message.retrievalTrace) ? message.retrievalTrace : undefined);
+  const sourceSummaries = buildRAGSourceSummaries(sources);
   const groundedAnswer = buildRAGGroundedAnswer(message.content, sources);
   return {
-    citationReferenceMap: buildRAGCitationReferenceMap(buildRAGCitations(sources)),
-    citations: buildRAGCitations(sources),
+    citationReferenceMap: buildRAGCitationReferenceMap(citations),
+    citations,
     conversationId: message.conversationId,
+    excerptModeCounts: buildRAGExcerptModeCounts([
+      ...citations.map((citation) => citation.excerptSelection),
+      ...sourceSummaries.map((summary) => summary.excerptSelection)
+    ]),
     groundedAnswer,
     messageId: message.id,
     retrievalDurationMs: message.retrievalDurationMs,
     retrievalStartedAt: message.retrievalStartedAt,
     retrievedAt: message.retrievedAt,
     trace: isRAGRetrievalTrace(message.retrievalTrace) ? message.retrievalTrace : undefined,
+    sectionDiagnostics,
     sourceGroups: buildRAGSourceGroups(sources),
-    sourceSummaries: buildRAGSourceSummaries(sources),
+    sourceSummaries,
     sources
   };
 };
@@ -4545,6 +4622,8 @@ var buildRAGSourceSummaries = (sources) => {
     const groupCitations = citations.filter((citation) => group.chunks.some((chunk) => chunk.chunkId === citation.chunkId));
     const leadChunk = group.chunks.slice().sort((left, right) => right.score - left.score)[0];
     const excerpts = leadChunk ? buildRAGChunkExcerpts(group.chunks, leadChunk.chunkId) : undefined;
+    const structure = leadChunk?.structure ?? buildRAGChunkStructure(leadChunk?.metadata);
+    const excerptSelection = buildRAGExcerptSelection(excerpts, structure);
     return {
       bestScore: group.bestScore,
       citationNumbers: groupCitations.map((citation) => citationReferenceMap[citation.chunkId] ?? 0),
@@ -4552,18 +4631,154 @@ var buildRAGSourceSummaries = (sources) => {
       chunkIds: group.chunks.map((chunk) => chunk.chunkId),
       contextLabel: leadChunk?.labels?.contextLabel ?? buildContextLabel2(leadChunk?.metadata),
       count: group.count,
-      excerpt: buildRAGPreferredExcerpt(excerpts, leadChunk?.structure ?? buildRAGChunkStructure(leadChunk?.metadata)) || buildExcerpt2(leadChunk?.text ?? ""),
+      excerpt: excerptSelection.excerpt || buildExcerpt2(leadChunk?.text ?? ""),
       excerpts,
+      excerptSelection,
       key: group.key,
       label: group.label,
       locatorLabel: leadChunk?.labels?.locatorLabel ?? buildLocatorLabel2(leadChunk?.metadata, leadChunk?.source, leadChunk?.title),
       provenanceLabel: leadChunk?.labels?.provenanceLabel ?? buildProvenanceLabel2(leadChunk?.metadata),
-      structure: leadChunk?.structure ?? buildRAGChunkStructure(leadChunk?.metadata),
+      structure,
       source: group.source,
       title: group.title
     };
   });
 };
+var getSectionPathFromSource = (source) => {
+  const path = source.structure?.section?.path ?? (Array.isArray(source.metadata?.sectionPath) ? source.metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : []);
+  return path.length > 0 ? path : undefined;
+};
+var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
+  const totalScore = sources.reduce((sum, source) => sum + source.score, 0);
+  if (sources.length === 0 || totalScore <= 0) {
+    return [];
+  }
+  const sections = new Map;
+  for (const source of sources) {
+    const path = getSectionPathFromSource(source);
+    if (!path) {
+      continue;
+    }
+    const key = path.join(" > ");
+    const label = path.at(-1) ?? key;
+    const parentLabel = path.length > 1 ? path.slice(0, -1).join(" > ") : undefined;
+    const existing = sections.get(key);
+    const channels = Array.isArray(source.metadata?.retrievalChannels) ? source.metadata.retrievalChannels.filter((value) => value === "vector" || value === "lexical") : [];
+    const isHybrid = channels.includes("vector") && channels.includes("lexical");
+    const vectorHits = channels.includes("vector") ? 1 : 0;
+    const lexicalHits = channels.includes("lexical") ? 1 : 0;
+    const hybridHits = isHybrid ? 1 : 0;
+    if (!existing) {
+      sections.set(key, {
+        bestScore: source.score,
+        count: 1,
+        hybridHits,
+        key,
+        label,
+        lexicalHits,
+        parentLabel,
+        path,
+        sourceSet: new Set(source.source ? [source.source] : []),
+        topChunkId: source.chunkId,
+        topSource: source.source,
+        totalScore: source.score,
+        vectorHits
+      });
+      continue;
+    }
+    existing.count += 1;
+    existing.totalScore += source.score;
+    if (source.source) {
+      existing.sourceSet.add(source.source);
+    }
+    existing.vectorHits += vectorHits;
+    existing.lexicalHits += lexicalHits;
+    existing.hybridHits += hybridHits;
+    if (source.score > existing.bestScore) {
+      existing.bestScore = source.score;
+      existing.topChunkId = source.chunkId;
+      existing.topSource = source.source;
+    }
+  }
+  const diagnostics = [...sections.values()];
+  const strongestBestHit = diagnostics.reduce((highest, section) => Math.max(highest, section.bestScore), 0);
+  return diagnostics.map((section) => {
+    const siblingPool = diagnostics.filter((entry) => entry.parentLabel === section.parentLabel);
+    const siblings = siblingPool.filter((entry) => entry.key !== section.key);
+    const strongestSibling = siblings.slice().sort((left, right) => right.totalScore - left.totalScore)[0];
+    const parentTotal = siblingPool.reduce((sum, entry) => sum + entry.totalScore, 0);
+    const scoreShare = section.totalScore / totalScore;
+    const parentShare = parentTotal > 0 ? section.totalScore / parentTotal : undefined;
+    const parentDistribution = parentTotal > 0 ? siblingPool.map((entry) => ({
+      count: entry.count,
+      isActive: entry.key === section.key,
+      key: entry.key,
+      label: entry.label,
+      parentShare: entry.totalScore / parentTotal,
+      totalScore: entry.totalScore
+    })).sort((left, right) => right.totalScore - left.totalScore) : [];
+    const reasons = [];
+    if (section.bestScore >= strongestBestHit) {
+      reasons.push("best_hit");
+    }
+    if (section.count > 1) {
+      reasons.push("multi_hit_section");
+    }
+    if (siblings.length === 0) {
+      reasons.push("only_section_in_parent");
+    } else if (!strongestSibling || section.totalScore >= strongestSibling.totalScore) {
+      reasons.push("dominant_within_parent");
+    }
+    if (scoreShare >= 0.5 || (parentShare ?? 0) >= 0.6) {
+      reasons.push("concentrated_evidence");
+    }
+    const summaryParts = [
+      `${section.count} hit${section.count === 1 ? "" : "s"}`,
+      `${(scoreShare * 100).toFixed(0)}% score share`,
+      `vector ${section.vectorHits} \xB7 lexical ${section.lexicalHits} \xB7 hybrid ${section.hybridHits}`,
+      typeof parentShare === "number" ? `${(parentShare * 100).toFixed(0)}% of parent section set` : "",
+      strongestSibling ? `ahead of ${strongestSibling.label} by ${(section.totalScore - strongestSibling.totalScore).toFixed(2)}` : "no sibling competition"
+    ].filter(Boolean);
+    return {
+      averageScore: section.totalScore / section.count,
+      bestScore: section.bestScore,
+      count: section.count,
+      key: section.key,
+      label: section.label,
+      parentLabel: section.parentLabel,
+      parentDistribution,
+      parentShare,
+      parentShareGap: typeof parentShare === "number" && strongestSibling && parentTotal > 0 ? parentShare - strongestSibling.totalScore / parentTotal : undefined,
+      path: section.path,
+      retrievalMode: trace?.mode,
+      reasons,
+      rerankApplied: trace?.steps.some((step) => step.stage === "rerank" && step.metadata?.applied === true),
+      scoreShare,
+      scoreThresholdApplied: trace?.steps.some((step) => step.stage === "score_filter"),
+      siblingCount: siblings.length,
+      siblingScoreGap: strongestSibling ? section.totalScore - strongestSibling.totalScore : undefined,
+      sourceCount: section.sourceSet.size,
+      sourceBalanceApplied: trace?.steps.some((step) => step.stage === "source_balance"),
+      strongestSiblingLabel: strongestSibling?.label,
+      strongestSiblingScore: strongestSibling?.totalScore,
+      summary: summaryParts.join(" \xB7 "),
+      topChunkId: section.topChunkId,
+      topSource: section.topSource,
+      totalScore: section.totalScore,
+      hybridHits: section.hybridHits,
+      lexicalHits: section.lexicalHits,
+      vectorHits: section.vectorHits
+    };
+  }).sort((left, right) => {
+    if (right.totalScore !== left.totalScore) {
+      return right.totalScore - left.totalScore;
+    }
+    if (right.bestScore !== left.bestScore) {
+      return right.bestScore - left.bestScore;
+    }
+    return left.label.localeCompare(right.label);
+  });
+};
 var buildStreamProgressState = (messages) => {
   const latestMessage = getLatestAssistantMessage(messages);
   const retrieved = latestMessage ? buildRAGRetrievedState(messages) : undefined;
@@ -4627,12 +4842,19 @@ var buildRAGAnswerWorkflowState = ({
   const groundingReferences = buildRAGGroundingReferences(sources);
   const groundedAnswer = buildRAGGroundedAnswer(latestAssistantMessage?.content ?? "", sources);
   const retrieval = buildRAGRetrievedState(messages);
+  const sectionDiagnostics = buildRAGSectionRetrievalDiagnostics(sources, retrieval?.trace);
   const progress = buildRAGStreamProgress({
     error,
     isStreaming,
     messages
   });
   return {
+    excerptModeCounts: buildRAGExcerptModeCounts([
+      ...citations.map((citation) => citation.excerptSelection),
+      ...sourceSummaries.map((summary) => summary.excerptSelection),
+      ...groundingReferences.map((reference) => reference.excerptSelection),
+      ...groundedAnswer.sectionSummaries.map((summary) => summary.excerptSelection)
+    ]),
     citationReferenceMap,
     citations,
     coverage: groundedAnswer.coverage,
@@ -4657,6 +4879,7 @@ var buildRAGAnswerWorkflowState = ({
     retrievalDurationMs: retrieval?.retrievalDurationMs,
     retrievalStartedAt: retrieval?.retrievalStartedAt,
     retrievedAt: retrieval?.retrievedAt,
+    sectionDiagnostics,
     sourceGroups,
     sourceSummaries,
     sources,
@@ -10305,6 +10528,26 @@ var weightQueryResults = (results, queryIndex) => {
     score: result.score * weight
   }));
 };
+var annotateRetrievalChannels = (input) => {
+  const vectorIds = new Set(input.vectorResults.map((result) => result.chunkId));
+  const lexicalIds = new Set(input.lexicalResults.map((result) => result.chunkId));
+  return input.results.map((result) => {
+    const channels = [];
+    if (vectorIds.has(result.chunkId)) {
+      channels.push("vector");
+    }
+    if (lexicalIds.has(result.chunkId)) {
+      channels.push("lexical");
+    }
+    return {
+      ...result,
+      metadata: {
+        ...result.metadata ?? {},
+        retrievalChannels: channels
+      }
+    };
+  });
+};
 var shouldRunVectorRetrieval = (mode) => mode === "vector" || mode === "hybrid";
 var shouldRunLexicalRetrieval = (mode, store) => mode === "lexical" || mode === "hybrid" && Boolean(store.queryLexical);
 var createRAGCollection = (options) => {
@@ -10495,7 +10738,11 @@ var createRAGCollection = (options) => {
         stage: "source_balance"
       });
     }
-    const limited = diversified.slice(0, topK);
+    const limited = annotateRetrievalChannels({
+      lexicalResults,
+      results: diversified.slice(0, topK),
+      vectorResults
+    });
     if (typeof input.scoreThreshold !== "number") {
       steps.push({
         count: limited.length,
@@ -10650,10 +10897,24 @@ var renderChunkExcerpts = (input) => {
   ].filter((row) => row.length > 0);
   return rows.length > 0 ? `<ul class="rag-chunk-structure">${rows.join("")}</ul>` : "";
 };
+var renderExcerptSelection = (selection) => {
+  if (!selection) {
+    return "";
+  }
+  const modeLabel = selection.mode === "chunk" ? "Chunk excerpt" : selection.mode === "window" ? "Neighbor window" : "Section excerpt";
+  const reasonLabel = selection.reason === "single_chunk" ? "single chunk" : selection.reason === "chunk_too_narrow" ? "chunk too narrow" : selection.reason === "section_small_enough" ? "section small enough" : "section too large, used window";
+  return `<ul class="rag-chunk-structure"><li><strong>Preferred excerpt</strong> ${escapeHtml2(modeLabel)}</li><li><strong>Promotion reason</strong> ${escapeHtml2(reasonLabel)}</li></ul>`;
+};
 var renderSectionJumpList = (label, items) => {
   const rows = items.map((item) => item.href ? `<li><strong>${escapeHtml2(label)}</strong> <a href="${escapeHtml2(item.href)}"${item.active ? ' aria-current="true"' : ""}>${escapeHtml2(item.label)}</a></li>` : `<li><strong>${escapeHtml2(label)}</strong> ${escapeHtml2(item.label)}</li>`).join("");
   return rows ? `<ul class="rag-chunk-structure">${rows}</ul>` : "";
 };
+var renderSectionDiagnostics = (diagnostics) => {
+  if (diagnostics.length === 0) {
+    return "";
+  }
+  return `<section class="rag-search-results"><h3>Section diagnostics</h3>` + diagnostics.map((diagnostic) => `<article class="rag-search-result" id="rag-section-diagnostic-${escapeHtml2(diagnostic.key)}">` + `<h4>${escapeHtml2(diagnostic.path?.join(" > ") ?? diagnostic.label)}</h4>` + `<p class="rag-search-source">${escapeHtml2(diagnostic.summary)}</p>` + `<ul class="rag-source-labels">` + `<li><strong>Top hit</strong> ${diagnostic.bestScore.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES)}</li>` + `<li><strong>Average</strong> ${diagnostic.averageScore.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES)}</li>` + `<li><strong>Sources</strong> ${diagnostic.sourceCount}</li>` + `<li><strong>Channels</strong> vector ${diagnostic.vectorHits} \xB7 lexical ${diagnostic.lexicalHits} \xB7 hybrid ${diagnostic.hybridHits}</li>` + `${diagnostic.retrievalMode ? `<li><strong>Trace mode</strong> ${escapeHtml2(diagnostic.retrievalMode)}</li>` : ""}` + `${diagnostic.rerankApplied !== undefined ? `<li><strong>Rerank</strong> ${diagnostic.rerankApplied ? "applied" : "skipped"}</li>` : ""}` + `${diagnostic.sourceBalanceApplied ? `<li><strong>Source balance</strong> applied</li>` : ""}` + `${diagnostic.scoreThresholdApplied ? `<li><strong>Score threshold</strong> applied</li>` : ""}` + `<li><strong>Reasons</strong> ${escapeHtml2(diagnostic.reasons.join(", ") || "none")}</li>` + `${diagnostic.strongestSiblingLabel ? `<li><strong>Strongest sibling</strong> ${escapeHtml2(diagnostic.strongestSiblingLabel)} (${diagnostic.strongestSiblingScore?.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES) ?? "n/a"})</li>` : ""}` + `${typeof diagnostic.parentShareGap === "number" ? `<li><strong>Parent share gap</strong> ${(diagnostic.parentShareGap * 100).toFixed(0)}%</li>` : ""}` + `</ul>` + `${diagnostic.parentDistribution.length > 0 ? `<ul class="rag-source-labels">${diagnostic.parentDistribution.map((entry) => `<li><strong>${entry.isActive ? "Active section" : "Peer section"}</strong> ${escapeHtml2(entry.label)} \xB7 ${(entry.parentShare * 100).toFixed(0)}% \xB7 ${entry.count} hit${entry.count === 1 ? "" : "s"}</li>`).join("")}</ul>` : ""}` + `</article>`).join("") + `</section>`;
+};
 var renderEmptyState = (kind) => {
   switch (kind) {
     case "documents":
@@ -10700,8 +10961,9 @@ var defaultSearchResults = ({
   trace
 }) => results.length === 0 ? renderEmptyState("searchResults") : (() => {
   const graph = buildRAGChunkGraph(results);
+  const sectionDiagnostics = buildRAGSectionRetrievalDiagnostics(results, trace);
   const availableChunkIds = new Set(results.map((result) => result.chunkId));
-  return `<section class="rag-search-results">` + `<p class="rag-search-summary">${results.length} results for ${escapeHtml2(query)}</p>` + (trace ? `<p class="rag-search-summary">mode=${escapeHtml2(trace.mode)} \xB7 final=${trace.resultCounts.final} \xB7 vector=${trace.resultCounts.vector} \xB7 lexical=${trace.resultCounts.lexical}</p>` : "") + `${results.map((result, index) => {
+  return `<section class="rag-search-results">` + `<p class="rag-search-summary">${results.length} results for ${escapeHtml2(query)}</p>` + `<p class="rag-search-summary">sections=${sectionDiagnostics.length}</p>` + (trace ? `<p class="rag-search-summary">mode=${escapeHtml2(trace.mode)} \xB7 final=${trace.resultCounts.final} \xB7 vector=${trace.resultCounts.vector} \xB7 lexical=${trace.resultCounts.lexical}</p>` : "") + renderSectionDiagnostics(sectionDiagnostics) + `${results.map((result, index) => {
     const navigation = buildRAGChunkGraphNavigation(graph, result.chunkId);
     const sectionJumps = [
       navigation.parentSection?.leadChunkId ? renderSectionJumpList("Parent section", [
@@ -10749,7 +11011,7 @@ var defaultChunkPreview = (input) => {
     return acc;
   }, []);
   const groupHtml = groups.map((group) => {
-    const chunkHtml = group.chunks.map((chunk) => '<article class="rag-chunk">' + `<h5>${escapeHtml2(chunk.chunkId)}</h5>` + `<p class="rag-chunk-meta">chunk ${typeof chunk.metadata?.chunkIndex === "number" ? chunk.metadata.chunkIndex : 0} of ${typeof chunk.metadata?.chunkCount === "number" ? chunk.metadata.chunkCount : input.chunks.length}</p>` + renderSourceLabels(chunk.labels) + renderChunkStructure(chunk.structure) + renderChunkExcerpts(chunk.excerpts) + `<pre>${escapeHtml2(chunk.text)}</pre>` + "</article>").join("");
+    const chunkHtml = group.chunks.map((chunk) => '<article class="rag-chunk">' + `<h5>${escapeHtml2(chunk.chunkId)}</h5>` + `<p class="rag-chunk-meta">chunk ${typeof chunk.metadata?.chunkIndex === "number" ? chunk.metadata.chunkIndex : 0} of ${typeof chunk.metadata?.chunkCount === "number" ? chunk.metadata.chunkCount : input.chunks.length}</p>` + renderSourceLabels(chunk.labels) + renderChunkStructure(chunk.structure) + renderChunkExcerpts(chunk.excerpts) + renderExcerptSelection(chunk.excerptSelection) + `<pre>${escapeHtml2(chunk.text)}</pre>` + "</article>").join("");
     return `<section class="rag-chunk-group"><h4>${escapeHtml2(group.title)}</h4>${chunkHtml}</section>`;
   }).join("");
   return `<section class="rag-chunk-preview">` + `<h3>${escapeHtml2(input.document.title)}</h3>` + `<p class="rag-chunk-preview-source">${escapeHtml2(input.document.source)}</p>` + renderSourceLabels(input.document.labels) + (navigation.parentSection ? renderSectionJumpList("Parent section", [
@@ -16343,10 +16605,14 @@ var ragChat = (config) => {
           title: preview.document.title
         })
       },
-      chunks: chunks.map((chunk) => ({
-        ...chunk,
-        excerpts: buildRAGChunkExcerpts(chunks, chunk.chunkId)
-      }))
+      chunks: chunks.map((chunk) => {
+        const excerpts = buildRAGChunkExcerpts(chunks, chunk.chunkId);
+        return {
+          ...chunk,
+          excerpts,
+          excerptSelection: buildRAGExcerptSelection(excerpts, chunk.structure)
+        };
+      })
     };
   };
   const handleDeleteDocument = async (id) => {
@@ -21942,5 +22208,5 @@ export {
   aiChat
 };
 
-//# debugId=B6314DD20BD25BC564756E2164756E21
+//# debugId=F53160ECD0505BE164756E2164756E21
 //# sourceMappingURL=index.js.map