@absolutejs/absolute 0.19.0-beta.535 → 0.19.0-beta.537

package/dist/ai/index.js

@@ -4718,6 +4718,69 @@ var formatTimestampLabel = (value) => {
     timeStyle: "short"
   });
 };
+var formatRAGTraceValue = (value) => {
+  if (typeof value === "string")
+    return value;
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    return value.join(", ");
+  }
+  if (value && typeof value === "object") {
+    return JSON.stringify(value);
+  }
+  return "n/a";
+};
+var buildRAGRetrievalTracePresentation = (trace) => {
+  if (!trace) {
+    return {
+      details: [],
+      stats: [],
+      steps: []
+    };
+  }
+  const stats = [
+    { label: "Mode", value: trace.mode },
+    { label: "Final Results", value: String(trace.resultCounts.final) },
+    {
+      label: "Vector Candidates",
+      value: String(trace.resultCounts.vector)
+    },
+    {
+      label: "Lexical Candidates",
+      value: String(trace.resultCounts.lexical)
+    }
+  ];
+  const details = [
+    { label: "Transformed query", value: trace.transformedQuery },
+    {
+      label: "Variant queries",
+      value: trace.variantQueries.length > 0 ? trace.variantQueries.join(" \xB7 ") : "none"
+    },
+    { label: "Candidate topK", value: String(trace.candidateTopK) },
+    { label: "Lexical topK", value: String(trace.lexicalTopK) }
+  ];
+  const steps = trace.steps.map((step) => ({
+    count: step.count,
+    label: step.label,
+    rows: [
+      { label: "stage", value: step.stage },
+      ...typeof step.count === "number" ? [{ label: "count", value: String(step.count) }] : [],
+      ...typeof step.durationMs === "number" ? [{ label: "durationMs", value: String(step.durationMs) }] : [],
+      ...Object.entries(step.metadata ?? {}).map(([key, value]) => ({
+        label: key,
+        value: formatRAGTraceValue(value)
+      }))
+    ],
+    stage: step.stage
+  }));
+  return {
+    details,
+    stats,
+    steps
+  };
+};
 var formatMediaTimestamp = (value) => {
   if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
     return;
@@ -5937,6 +6000,64 @@ var buildRAGEvaluationHistoryRows = (history) => {
   }
   return rows;
 };
+var buildRAGEvaluationCaseTracePresentations = (history) => {
+  if (!history?.caseTraceSnapshots.length) {
+    return [];
+  }
+  return history.caseTraceSnapshots.map((entry) => {
+    const label = entry.label ?? entry.caseId;
+    const currentMode = entry.traceMode ?? "no-trace";
+    const previousMode = entry.previousTraceMode ?? "n/a";
+    const currentVariants = entry.variantQueries.length > 0 ? entry.variantQueries.join(", ") : "none";
+    const previousVariants = entry.previousVariantQueries.length > 0 ? entry.previousVariantQueries.join(", ") : "none";
+    const currentStages = Object.keys(entry.stageCounts).length > 0 ? Object.entries(entry.stageCounts).map(([stage, count]) => `${stage} ${count}`).join(", ") : "none";
+    const previousStages = Object.keys(entry.previousStageCounts).length > 0 ? Object.entries(entry.previousStageCounts).map(([stage, count]) => `${stage} ${count}`).join(", ") : "none";
+    return {
+      caseId: entry.caseId,
+      label,
+      summary: `${entry.traceChange} \xB7 ${previousMode}\u2192${currentMode} \xB7 final ${entry.previousFinalCount ?? 0}\u2192${entry.finalCount}`,
+      traceChange: entry.traceChange,
+      rows: [
+        { label: "Query", value: entry.query },
+        { label: "Trace change", value: entry.traceChange },
+        { label: "Mode", value: `${previousMode}\u2192${currentMode}` },
+        {
+          label: "Transformed query",
+          value: `${entry.previousTransformedQuery?.trim() || "n/a"}\u2192${entry.transformedQuery?.trim() || "n/a"}`
+        },
+        {
+          label: "Final",
+          value: `${entry.previousFinalCount ?? 0}\u2192${entry.finalCount}`
+        },
+        {
+          label: "Vector",
+          value: `${entry.previousVectorCount ?? 0}\u2192${entry.vectorCount}`
+        },
+        {
+          label: "Lexical",
+          value: `${entry.previousLexicalCount ?? 0}\u2192${entry.lexicalCount}`
+        },
+        {
+          label: "Candidate topK",
+          value: `${entry.previousCandidateTopK ?? 0}\u2192${entry.candidateTopK}`
+        },
+        {
+          label: "Lexical topK",
+          value: `${entry.previousLexicalTopK ?? 0}\u2192${entry.lexicalTopK}`
+        },
+        {
+          label: "Variants",
+          value: `${previousVariants}\u2192${currentVariants}`
+        },
+        {
+          label: "Stages",
+          value: `${previousStages}\u2192${currentStages}`
+        },
+        { label: "Status", value: entry.status }
+      ]
+    };
+  });
+};
 var buildRAGEvaluationRunDiff = ({
   current,
   previous
@@ -11622,6 +11743,7 @@ export {
   geminiEmbeddings,
   gemini,
   fuseRAGQueryResults,
+  formatRAGTraceValue,
   executeDryRunRAGEvaluation,
   evaluateRAGCollection,
   evaluateRAGAnswerGroundingCase,
@@ -11684,6 +11806,7 @@ export {
   buildRAGStreamProgress,
   buildRAGSourceSummaries,
   buildRAGSourceGroups,
+  buildRAGRetrievalTracePresentation,
   buildRAGLexicalHaystack,
   buildRAGGroundingReferences,
   buildRAGGroundedAnswer,
@@ -11691,6 +11814,7 @@ export {
   buildRAGEvaluationResponse,
   buildRAGEvaluationLeaderboard,
   buildRAGEvaluationHistoryRows,
+  buildRAGEvaluationCaseTracePresentations,
   buildRAGContext,
   buildRAGComparisonTraceSummaryRows,
   buildRAGComparisonTraceDiffRows,
@@ -11709,5 +11833,5 @@ export {
   aiChat
 };
 
-//# debugId=3B5842716560251D64756E2164756E21
+//# debugId=BBC0B1F804D3DF1E64756E2164756E21
 //# sourceMappingURL=index.js.map