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

package/dist/ai/index.js

@@ -4718,6 +4718,12 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
       totalScore: entry.totalScore
     })).sort((left, right) => right.totalScore - left.totalScore) : [];
     const reasons = [];
+    const stageCounts = trace?.steps.map((step) => ({
+      count: step.sectionCounts?.find((entry) => entry.key === section.key)?.count ?? 0,
+      stage: step.stage
+    })).filter((entry) => entry.count > 0) ?? [];
+    const firstSeenStage = stageCounts[0]?.stage;
+    const lastSeenStage = stageCounts.at(-1)?.stage;
     if (section.bestScore >= strongestBestHit) {
       reasons.push("best_hit");
     }
@@ -4750,11 +4756,14 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
       parentShare,
       parentShareGap: typeof parentShare === "number" && strongestSibling && parentTotal > 0 ? parentShare - strongestSibling.totalScore / parentTotal : undefined,
       path: section.path,
+      firstSeenStage,
+      lastSeenStage,
       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"),
+      stageCounts,
       siblingCount: siblings.length,
       siblingScoreGap: strongestSibling ? section.totalScore - strongestSibling.totalScore : undefined,
       sourceCount: section.sourceSet.size,
@@ -10548,6 +10557,32 @@ var annotateRetrievalChannels = (input) => {
     };
   });
 };
+var buildTraceSectionCounts = (results) => {
+  const sections = new Map;
+  for (const result of results) {
+    const path = Array.isArray(result.metadata?.sectionPath) ? result.metadata.sectionPath.filter((value) => typeof value === "string" && value.trim().length > 0) : [];
+    if (path.length === 0) {
+      continue;
+    }
+    const key = path.join(" > ");
+    const existing = sections.get(key);
+    if (existing) {
+      existing.count += 1;
+      continue;
+    }
+    sections.set(key, {
+      count: 1,
+      key,
+      label: path.at(-1) ?? key
+    });
+  }
+  return [...sections.values()].sort((left, right) => {
+    if (right.count !== left.count) {
+      return right.count - left.count;
+    }
+    return left.key.localeCompare(right.key);
+  });
+};
 var shouldRunVectorRetrieval = (mode) => mode === "vector" || mode === "hybrid";
 var shouldRunLexicalRetrieval = (mode, store) => mode === "lexical" || mode === "hybrid" && Boolean(store.queryLexical);
 var createRAGCollection = (options) => {
@@ -10661,6 +10696,7 @@ var createRAGCollection = (options) => {
           queryCount: searchQueries.length,
           topK: candidateTopK
         },
+        sectionCounts: buildTraceSectionCounts(vectorResults),
         stage: "vector_search"
       });
     }
@@ -10673,6 +10709,7 @@ var createRAGCollection = (options) => {
           queryCount: searchQueries.length,
           topK: lexicalTopK
         },
+        sectionCounts: buildTraceSectionCounts(lexicalResults),
         stage: "lexical_search"
       });
     }
@@ -10690,6 +10727,7 @@ var createRAGCollection = (options) => {
       metadata: {
         mode: retrieval.mode
       },
+      sectionCounts: buildTraceSectionCounts(results),
       stage: "fusion"
     });
     const rerankInput = {
@@ -10712,6 +10750,7 @@ var createRAGCollection = (options) => {
       metadata: {
         applied: hasReranker
       },
+      sectionCounts: buildTraceSectionCounts(reranked),
       stage: "rerank"
     });
     const diversityAdjusted = retrieval.diversityStrategy === "mmr" ? applyRAGMMRDiversity(reranked, queryVector, retrieval.mmrLambda) : reranked;
@@ -10723,6 +10762,7 @@ var createRAGCollection = (options) => {
           applied: queryVector.length > 0 && diversityAdjusted.some((entry) => Array.isArray(entry.embedding)),
           mmrLambda: retrieval.mmrLambda
         },
+        sectionCounts: buildTraceSectionCounts(diversityAdjusted),
         stage: "diversity"
       });
     }
@@ -10735,6 +10775,7 @@ var createRAGCollection = (options) => {
           maxResultsPerSource: retrieval.maxResultsPerSource,
           strategy: retrieval.sourceBalanceStrategy
         },
+        sectionCounts: buildTraceSectionCounts(diversified),
         stage: "source_balance"
       });
     }
@@ -10750,6 +10791,7 @@ var createRAGCollection = (options) => {
         metadata: {
           appliedScoreThreshold: false
         },
+        sectionCounts: buildTraceSectionCounts(limited),
         stage: "finalize"
       });
       return {
@@ -10787,6 +10829,7 @@ var createRAGCollection = (options) => {
       metadata: {
         scoreThreshold
       },
+      sectionCounts: buildTraceSectionCounts(filtered),
       stage: "score_filter"
     });
     steps.push({
@@ -10795,6 +10838,7 @@ var createRAGCollection = (options) => {
       metadata: {
         appliedScoreThreshold: true
       },
+      sectionCounts: buildTraceSectionCounts(filtered),
       stage: "finalize"
     });
     return {
@@ -10913,7 +10957,7 @@ 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>`;
+  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.stageCounts.length > 0 ? `<li><strong>Stage flow</strong> ${escapeHtml2(diagnostic.stageCounts.map((entry) => `${entry.stage} ${entry.count}`).join(" \u2192 "))}</li>` : ""}` + `${diagnostic.firstSeenStage ? `<li><strong>First seen</strong> ${escapeHtml2(diagnostic.firstSeenStage)}</li>` : ""}` + `${diagnostic.lastSeenStage ? `<li><strong>Last seen</strong> ${escapeHtml2(diagnostic.lastSeenStage)}</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) {
@@ -22208,5 +22252,5 @@ export {
   aiChat
 };
 
-//# debugId=F53160ECD0505BE164756E2164756E21
+//# debugId=405B1228CB22607264756E2164756E21
 //# sourceMappingURL=index.js.map