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

package/dist/ai/rag/quality.js

@@ -341,21 +341,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;
@@ -411,8 +438,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,
@@ -429,11 +457,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),
@@ -454,6 +485,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;
@@ -497,10 +529,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)
   };
 };
@@ -519,8 +555,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,
@@ -556,6 +593,9 @@ var buildRAGGroundedAnswerSectionSummaries = (references) => {
       };
       existing.excerpt = reference.excerpts.sectionExcerpt;
     }
+    if (!existing.excerptSelection && reference.excerptSelection) {
+      existing.excerptSelection = reference.excerptSelection;
+    }
   }
   return [...groups.values()].map((group) => ({
     ...group,
@@ -575,11 +615,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,
@@ -3751,5 +3793,5 @@ export {
   buildRAGAnswerGroundingCaseDifficultyLeaderboard
 };
 
-//# debugId=052710711C1D68E964756E2164756E21
+//# debugId=40702D5082EC52F464756E2164756E21
 //# sourceMappingURL=quality.js.map