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

package/dist/ai/client/index.js

@@ -5265,6 +5265,10 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
     const vectorHits = channels.includes("vector") ? 1 : 0;
     const lexicalHits = channels.includes("lexical") ? 1 : 0;
     const hybridHits = isHybrid ? 1 : 0;
+    const queryOrigin = source.metadata?.retrievalQueryOrigin;
+    const primaryHits = queryOrigin === "primary" ? 1 : 0;
+    const transformedHits = queryOrigin === "transformed" ? 1 : 0;
+    const variantHits = queryOrigin === "variant" ? 1 : 0;
     if (!existing) {
       sections.set(key, {
         bestScore: source.score,
@@ -5275,10 +5279,13 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
         lexicalHits,
         parentLabel,
         path,
+        primaryHits,
         sourceSet: new Set(source.source ? [source.source] : []),
         topChunkId: source.chunkId,
         topSource: source.source,
         totalScore: source.score,
+        transformedHits,
+        variantHits,
         vectorHits
       });
       continue;
@@ -5291,6 +5298,9 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
     existing.vectorHits += vectorHits;
     existing.lexicalHits += lexicalHits;
     existing.hybridHits += hybridHits;
+    existing.primaryHits += primaryHits;
+    existing.transformedHits += transformedHits;
+    existing.variantHits += variantHits;
     if (source.score > existing.bestScore) {
       existing.bestScore = source.score;
       existing.topChunkId = source.chunkId;
@@ -5299,6 +5309,9 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
   }
   const diagnostics = [...sections.values()];
   const strongestBestHit = diagnostics.reduce((highest, section) => Math.max(highest, section.bestScore), 0);
+  const parentLabelByKey = new Map(diagnostics.map((section) => [section.key, section.parentLabel]));
+  const stageSectionCounts = new Map((trace?.steps ?? []).filter((step) => Array.isArray(step.sectionCounts) && step.sectionCounts.length > 0).map((step) => [step.stage, step.sectionCounts ?? []]));
+  const stageSectionScores = new Map((trace?.steps ?? []).filter((step) => Array.isArray(step.sectionScores) && step.sectionScores.length > 0).map((step) => [step.stage, step.sectionScores ?? []]));
   return diagnostics.map((section) => {
     const siblingPool = diagnostics.filter((entry) => entry.parentLabel === section.parentLabel);
     const siblings = siblingPool.filter((entry) => entry.key !== section.key);
@@ -5319,8 +5332,103 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
       count: step.sectionCounts?.find((entry) => entry.key === section.key)?.count ?? 0,
       stage: step.stage
     })).filter((entry) => entry.count > 0) ?? [];
+    const stageWeights = stageCounts.map((entry) => {
+      const previousStageEntry = stageCounts[stageCounts.findIndex((candidate) => candidate.stage === entry.stage) - 1];
+      const stageEntries = stageSectionCounts.get(entry.stage)?.filter((candidate) => candidate.count > 0) ?? [];
+      const stageScoreEntries = stageSectionScores.get(entry.stage)?.filter((candidate) => candidate.totalScore > 0) ?? [];
+      const stageTotal = stageEntries.reduce((sum, candidate) => sum + candidate.count, 0);
+      const stageScoreTotal = stageScoreEntries.reduce((sum, candidate) => sum + candidate.totalScore, 0);
+      const siblingStageEntries = stageEntries.filter((candidate) => candidate.key !== section.key && parentLabelByKey.get(candidate.key) === section.parentLabel);
+      const parentStageEntries = stageEntries.filter((candidate) => parentLabelByKey.get(candidate.key) === section.parentLabel);
+      const siblingStageScoreEntries = stageScoreEntries.filter((candidate) => candidate.key !== section.key && parentLabelByKey.get(candidate.key) === section.parentLabel);
+      const parentStageScoreEntries = stageScoreEntries.filter((candidate) => parentLabelByKey.get(candidate.key) === section.parentLabel);
+      const strongestStageSibling = siblingStageEntries.slice().sort((left, right) => right.count - left.count)[0];
+      const parentStageTotal = parentStageEntries.reduce((sum, candidate) => sum + candidate.count, 0);
+      const activeStageScore = stageScoreEntries.find((candidate) => candidate.key === section.key)?.totalScore;
+      const strongestStageScoreSibling = siblingStageScoreEntries.slice().sort((left, right) => right.totalScore - left.totalScore)[0];
+      const parentStageScoreTotal = parentStageScoreEntries.reduce((sum, candidate) => sum + candidate.totalScore, 0);
+      const stageShare = stageTotal > 0 ? entry.count / stageTotal : 0;
+      const retentionRate = typeof previousStageEntry?.count === "number" && previousStageEntry.count > 0 ? entry.count / previousStageEntry.count : undefined;
+      const countDelta = typeof previousStageEntry?.count === "number" ? entry.count - previousStageEntry.count : undefined;
+      const parentStageShare = parentStageTotal > 0 ? entry.count / parentStageTotal : undefined;
+      const stageScoreShare = typeof activeStageScore === "number" && stageScoreTotal > 0 ? activeStageScore / stageScoreTotal : undefined;
+      const parentStageScoreShare = typeof activeStageScore === "number" && parentStageScoreTotal > 0 ? activeStageScore / parentStageScoreTotal : undefined;
+      const stageShareGap = stageTotal > 0 && strongestStageSibling ? entry.count / stageTotal - strongestStageSibling.count / stageTotal : undefined;
+      const parentStageShareGap = parentStageTotal > 0 && strongestStageSibling ? entry.count / parentStageTotal - strongestStageSibling.count / parentStageTotal : undefined;
+      const stageScoreShareGap = typeof activeStageScore === "number" && stageScoreTotal > 0 && strongestStageScoreSibling ? activeStageScore / stageScoreTotal - strongestStageScoreSibling.totalScore / stageScoreTotal : undefined;
+      const parentStageScoreShareGap = typeof activeStageScore === "number" && parentStageScoreTotal > 0 && strongestStageScoreSibling ? activeStageScore / parentStageScoreTotal - strongestStageScoreSibling.totalScore / parentStageScoreTotal : undefined;
+      const reasons2 = [];
+      if (entry.stage === "rerank" && stageShare > 0.5 && (typeof stageShareGap !== "number" || stageShareGap > 0)) {
+        reasons2.push("rerank_preserved_lead");
+      }
+      if (entry.stage === "finalize" && stageShare >= 0.5) {
+        reasons2.push("final_stage_concentration");
+      }
+      if (entry.stage === "finalize" && typeof parentStageShare === "number" && parentStageShare >= 0.6 && (typeof parentStageShareGap !== "number" || parentStageShareGap > 0)) {
+        reasons2.push("final_stage_dominant_within_parent");
+      }
+      if (strongestStageSibling && (typeof stageShareGap === "number" && stageShareGap <= 0.1 || typeof parentStageShareGap === "number" && parentStageShareGap <= 0.1)) {
+        reasons2.push("stage_runner_up_pressure");
+      }
+      if (typeof countDelta === "number") {
+        if (countDelta > 0) {
+          reasons2.push("stage_expanded");
+        } else if (countDelta < 0) {
+          reasons2.push("stage_narrowed");
+        } else {
+          reasons2.push("stage_held");
+        }
+      }
+      return {
+        count: entry.count,
+        countDelta,
+        parentStageScoreShare,
+        parentStageShare,
+        parentStageShareGap,
+        previousCount: previousStageEntry?.count,
+        previousStage: previousStageEntry?.stage,
+        reasons: reasons2,
+        retentionRate,
+        stage: entry.stage,
+        stageScoreShare,
+        stageScoreShareGap,
+        stageShare,
+        stageShareGap,
+        totalScore: activeStageScore,
+        strongestSiblingCount: strongestStageSibling?.count,
+        strongestSiblingLabel: strongestStageSibling ? diagnostics.find((candidate) => candidate.key === strongestStageSibling.key)?.label ?? strongestStageSibling.key : undefined
+      };
+    });
     const firstSeenStage = stageCounts[0]?.stage;
     const lastSeenStage = stageCounts.at(-1)?.stage;
+    const peakStageEntry = stageCounts.reduce((highest, entry) => !highest || entry.count > highest.count ? entry : highest, undefined);
+    const finalStageEntry = stageCounts.at(-1);
+    const peakCount = peakStageEntry?.count ?? section.count;
+    const finalCount = finalStageEntry?.count;
+    const finalRetentionRate = typeof finalCount === "number" && peakCount > 0 ? finalCount / peakCount : undefined;
+    const dropFromPeak = typeof finalCount === "number" ? peakCount - finalCount : undefined;
+    const queryAttributionReasons = [];
+    const queryAttributionMode = section.primaryHits > 0 && section.transformedHits === 0 && section.variantHits === 0 ? "primary" : section.transformedHits > 0 && section.primaryHits === 0 && section.variantHits === 0 ? "transformed" : section.variantHits > 0 && section.primaryHits === 0 && section.transformedHits === 0 ? "variant" : "mixed";
+    if (queryAttributionMode === "primary") {
+      queryAttributionReasons.push("base_query_only");
+    }
+    if (queryAttributionMode === "transformed") {
+      queryAttributionReasons.push("transformed_query_only");
+      queryAttributionReasons.push("transform_introduced");
+    }
+    if (queryAttributionMode === "variant") {
+      queryAttributionReasons.push("variant_only");
+      queryAttributionReasons.push("variant_supported");
+    }
+    if (queryAttributionMode === "mixed") {
+      queryAttributionReasons.push("mixed_query_sources");
+      if (section.variantHits > 0) {
+        queryAttributionReasons.push("variant_supported");
+      }
+      if (section.transformedHits > 0 && section.primaryHits === 0) {
+        queryAttributionReasons.push("transform_introduced");
+      }
+    }
     if (section.bestScore >= strongestBestHit) {
       reasons.push("best_hit");
     }
@@ -5354,13 +5462,26 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
       parentShareGap: typeof parentShare === "number" && strongestSibling && parentTotal > 0 ? parentShare - strongestSibling.totalScore / parentTotal : undefined,
       path: section.path,
       firstSeenStage,
+      finalCount,
+      finalRetentionRate,
       lastSeenStage,
+      dropFromPeak,
+      peakCount,
+      peakStage: peakStageEntry?.stage,
+      queryAttribution: {
+        mode: queryAttributionMode,
+        primaryHits: section.primaryHits,
+        reasons: queryAttributionReasons,
+        transformedHits: section.transformedHits,
+        variantHits: section.variantHits
+      },
       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,
+      stageWeights,
       siblingCount: siblings.length,
       siblingScoreGap: strongestSibling ? section.totalScore - strongestSibling.totalScore : undefined,
       sourceCount: section.sourceSet.size,
@@ -7315,5 +7436,5 @@ export {
   buildRAGEvaluationLeaderboard
 };
 
-//# debugId=B8C0E5F952AE116E64756E2164756E21
+//# debugId=7134089E98D0712964756E2164756E21
 //# sourceMappingURL=index.js.map