@absolutejs/absolute 0.19.0-beta.605 → 0.19.0-beta.607

package/dist/react/ai/index.js

@@ -354,6 +354,13 @@ var buildGroundingReferenceEvidenceSummary = (reference) => [
   reference.contextLabel,
   reference.provenanceLabel
 ].filter((value) => Boolean(value && value.length > 0)).filter((value, index, values) => values.findIndex((entry) => entry === value) === index).join(" \xB7 ");
+var buildGroundingSectionKey = (reference) => reference.contextLabel ?? reference.locatorLabel ?? reference.label ?? reference.source ?? reference.chunkId;
+var buildGroundingSectionSummaryLine = (reference) => [
+  reference.source ?? reference.title ?? reference.chunkId,
+  reference.locatorLabel,
+  reference.contextLabel,
+  reference.provenanceLabel
+].filter((value) => Boolean(value && value.length > 0)).filter((value, index, values) => values.findIndex((entry) => entry === value) === index).join(" \xB7 ");
 var buildGroundedAnswerCitationDetail = (reference) => ({
   contextLabel: reference.contextLabel,
   evidenceLabel: buildGroundingReferenceEvidenceLabel(reference),
@@ -444,9 +451,61 @@ var buildRAGGroundedAnswer = (content, sources) => {
     hasCitations,
     parts,
     references,
+    sectionSummaries: buildRAGGroundedAnswerSectionSummaries(references),
     ungroundedReferenceNumbers: [...ungroundedReferenceNumbers].sort((left, right) => left - right)
   };
 };
+var buildRAGGroundedAnswerSectionSummaries = (references) => {
+  const groups = new Map;
+  for (const reference of references) {
+    const key = buildGroundingSectionKey(reference);
+    const existing = groups.get(key);
+    if (!existing) {
+      groups.set(key, {
+        chunkIds: [reference.chunkId],
+        contextLabel: reference.contextLabel,
+        count: 1,
+        key,
+        label: key,
+        locatorLabel: reference.locatorLabel,
+        provenanceLabel: reference.provenanceLabel,
+        referenceNumbers: [reference.number],
+        references: [reference],
+        summary: buildGroundingSectionSummaryLine(reference) || reference.label || reference.chunkId
+      });
+      continue;
+    }
+    existing.count += 1;
+    if (!existing.chunkIds.includes(reference.chunkId)) {
+      existing.chunkIds.push(reference.chunkId);
+    }
+    if (!existing.referenceNumbers.includes(reference.number)) {
+      existing.referenceNumbers.push(reference.number);
+    }
+    existing.references.push(reference);
+    if (!existing.contextLabel && reference.contextLabel) {
+      existing.contextLabel = reference.contextLabel;
+    }
+    if (!existing.locatorLabel && reference.locatorLabel) {
+      existing.locatorLabel = reference.locatorLabel;
+    }
+    if (!existing.provenanceLabel && reference.provenanceLabel) {
+      existing.provenanceLabel = reference.provenanceLabel;
+    }
+  }
+  return [...groups.values()].map((group) => ({
+    ...group,
+    referenceNumbers: [...group.referenceNumbers].sort((left, right) => left - right),
+    references: group.references.slice().sort((left, right) => left.number - right.number)
+  })).sort((left, right) => {
+    const leftFirst = left.referenceNumbers[0] ?? Number.POSITIVE_INFINITY;
+    const rightFirst = right.referenceNumbers[0] ?? Number.POSITIVE_INFINITY;
+    if (leftFirst !== rightFirst) {
+      return leftFirst - rightFirst;
+    }
+    return left.label.localeCompare(right.label);
+  });
+};
 var buildRAGGroundingReferences = (sources) => {
   const citations = buildRAGCitations(sources);
   const citationReferenceMap = buildRAGCitationReferenceMap(citations);
@@ -4204,11 +4263,13 @@ var buildRAGChunkGraph = (chunks) => {
       const existing = sections.get(sectionId);
       if (!existing) {
         sections.set(sectionId, {
+          childSectionIds: [],
           chunkCount: structure.sequence?.sectionChunkCount ?? 1,
           chunkIds: [chunk.chunkId],
           depth: structure.section?.depth,
           id: sectionId,
           kind: structure.section?.kind,
+          leadChunkId: chunk.chunkId,
           path: structure.section?.path,
           title: structure.section?.title
         });
@@ -4231,6 +4292,48 @@ var buildRAGChunkGraph = (chunks) => {
       }
       return left.localeCompare(right);
     });
+    section.leadChunkId = section.chunkIds[0];
+  }
+  const sectionPathIndex = new Map;
+  for (const section of sections.values()) {
+    const path = section.path && section.path.length > 0 ? section.path : section.title ? [section.title] : undefined;
+    if (path && path.length > 0) {
+      sectionPathIndex.set(path.join("\x00"), section);
+    }
+  }
+  for (const section of sections.values()) {
+    const path = section.path && section.path.length > 0 ? section.path : section.title ? [section.title] : undefined;
+    if (!path || path.length < 2) {
+      continue;
+    }
+    const parent = sectionPathIndex.get(path.slice(0, -1).join("\x00"));
+    if (!parent || parent.id === section.id) {
+      continue;
+    }
+    section.parentSectionId = parent.id;
+    if (!parent.childSectionIds.includes(section.id)) {
+      parent.childSectionIds.push(section.id);
+    }
+    if (parent.leadChunkId && section.leadChunkId) {
+      const parentKey = `section_parent:${section.leadChunkId}:${parent.leadChunkId}`;
+      if (!edgeKeys.has(parentKey)) {
+        edgeKeys.add(parentKey);
+        edges.push({
+          fromChunkId: section.leadChunkId,
+          relation: "section_parent",
+          toChunkId: parent.leadChunkId
+        });
+      }
+      const childKey = `section_child:${parent.leadChunkId}:${section.leadChunkId}`;
+      if (!edgeKeys.has(childKey)) {
+        edgeKeys.add(childKey);
+        edges.push({
+          fromChunkId: parent.leadChunkId,
+          relation: "section_child",
+          toChunkId: section.leadChunkId
+        });
+      }
+    }
   }
   nodes.sort((left, right) => {
     const leftSection = left.structure?.sequence?.sectionChunkIndex ?? Number.MAX_SAFE_INTEGER;
@@ -4264,6 +4367,8 @@ var buildRAGChunkGraphNavigation = (graph, activeChunkId) => {
   if (graph.nodes.length === 0) {
     return {
       activeChunkId,
+      childSections: [],
+      siblingSections: [],
       sectionNodes: []
     };
   }
@@ -4272,13 +4377,19 @@ var buildRAGChunkGraphNavigation = (graph, activeChunkId) => {
   const previousNode = activeNode?.structure?.sequence?.previousChunkId ? graph.nodes.find((node) => node.chunkId === activeNode.structure?.sequence?.previousChunkId) : undefined;
   const nextNode = activeNode?.structure?.sequence?.nextChunkId ? graph.nodes.find((node) => node.chunkId === activeNode.structure?.sequence?.nextChunkId) : undefined;
   const section = activeNode?.structure?.sequence?.sectionChunkId ? graph.sections.find((entry) => entry.id === activeNode.structure?.sequence?.sectionChunkId) : undefined;
+  const parentSection = section?.parentSectionId ? graph.sections.find((entry) => entry.id === section.parentSectionId) : undefined;
+  const childSections = section ? section.childSectionIds.map((sectionId) => graph.sections.find((entry) => entry.id === sectionId)).filter((entry) => Boolean(entry)) : [];
+  const siblingSections = section?.parentSectionId ? graph.sections.filter((entry) => entry.parentSectionId === section.parentSectionId && entry.id !== section.id) : [];
   const sectionNodes = section ? section.chunkIds.map((chunkId) => graph.nodes.find((node) => node.chunkId === chunkId)).filter((node) => Boolean(node)) : activeNode ? [activeNode] : [];
   return {
     activeChunkId: resolvedActiveChunkId,
     activeNode,
+    childSections,
     nextNode,
+    parentSection,
     previousNode,
     section,
+    siblingSections,
     sectionNodes
   };
 };
@@ -6995,6 +7106,24 @@ var useRAGChunkPreview = (path) => {
   const selectChunk = useCallback2((id) => {
     setActiveChunkId(id);
   }, []);
+  const selectParentSection = useCallback2(() => {
+    const leadChunkId = navigation?.parentSection?.leadChunkId;
+    if (leadChunkId) {
+      setActiveChunkId(leadChunkId);
+    }
+  }, [navigation]);
+  const selectChildSection = useCallback2((sectionId) => {
+    const leadChunkId = navigation?.childSections.find((section) => section.id === sectionId)?.leadChunkId;
+    if (leadChunkId) {
+      setActiveChunkId(leadChunkId);
+    }
+  }, [navigation]);
+  const selectSiblingSection = useCallback2((sectionId) => {
+    const leadChunkId = navigation?.siblingSections.find((section) => section.id === sectionId)?.leadChunkId;
+    if (leadChunkId) {
+      setActiveChunkId(leadChunkId);
+    }
+  }, [navigation]);
   return {
     activeChunkId,
     chunkGraph,
@@ -7004,7 +7133,10 @@ var useRAGChunkPreview = (path) => {
     isLoading,
     navigation,
     preview,
-    selectChunk
+    selectChildSection,
+    selectChunk,
+    selectParentSection,
+    selectSiblingSection
   };
 };
 // src/react/ai/useRAG.ts
@@ -7579,7 +7711,7 @@ var useRAGSearch = (path) => {
 };
 
 // src/react/ai/useRAGSources.ts
-import { useMemo as useMemo10 } from "react";
+import { useCallback as useCallback9, useMemo as useMemo10 } from "react";
 var useRAGSources = (messages) => {
   const latestAssistantMessage = useMemo10(() => getLatestAssistantMessage(messages), [messages]);
   const sources = useMemo10(() => getLatestRAGSources(messages), [messages]);
@@ -7587,11 +7719,13 @@ var useRAGSources = (messages) => {
   const sourceSummaries = useMemo10(() => buildRAGSourceSummaries(sources), [sources]);
   const chunkGraph = useMemo10(() => buildRAGChunkGraph(sources), [sources]);
   const citationReferenceMap = useMemo10(() => buildRAGCitationReferenceMap(sourceSummaries.flatMap((summary) => summary.citations)), [sourceSummaries]);
+  const navigationForChunk = useCallback9((chunkId) => buildRAGChunkGraphNavigation(chunkGraph, chunkId ?? undefined), [chunkGraph]);
   return {
     citationReferenceMap,
     chunkGraph,
     hasSources: sources.length > 0,
     latestAssistantMessage,
+    navigationForChunk,
     sourceGroups,
     sources,
     sourceSummaries
@@ -7599,14 +7733,14 @@ var useRAGSources = (messages) => {
 };
 
 // src/react/ai/useRAGStatus.ts
-import { useCallback as useCallback9, useEffect as useEffect4, useMemo as useMemo11, useState as useState8 } from "react";
+import { useCallback as useCallback10, useEffect as useEffect4, useMemo as useMemo11, useState as useState8 } from "react";
 var useRAGStatus = (path, autoLoad = true) => {
   const client = useMemo11(() => createRAGClient({ path }), [path]);
   const [status, setStatus] = useState8();
   const [capabilities, setCapabilities] = useState8();
   const [error, setError] = useState8(null);
   const [isLoading, setIsLoading] = useState8(autoLoad);
-  const refresh = useCallback9(async () => {
+  const refresh = useCallback10(async () => {
     setIsLoading(true);
     setError(null);
     try {
@@ -7622,7 +7756,7 @@ var useRAGStatus = (path, autoLoad = true) => {
       setIsLoading(false);
     }
   }, [client]);
-  const reset = useCallback9(() => {
+  const reset = useCallback10(() => {
     setCapabilities(undefined);
     setError(null);
     setIsLoading(false);
@@ -7649,7 +7783,7 @@ var useRAGStatus = (path, autoLoad = true) => {
 import { useMemo as useMemo13 } from "react";
 
 // src/react/ai/useRAGStream.ts
-import { useCallback as useCallback10, useMemo as useMemo12 } from "react";
+import { useCallback as useCallback11, useMemo as useMemo12 } from "react";
 var useRAGStream = (path, conversationId) => {
   const stream = useAIStream(path, conversationId);
   const workflow = useMemo12(() => buildRAGAnswerWorkflowState({
@@ -7679,7 +7813,7 @@ var useRAGStream = (path, conversationId) => {
     sourceCount: workflow.sources.length,
     stage: workflow.stage
   }), [workflow]);
-  const query = useCallback10((content, attachments) => {
+  const query = useCallback11((content, attachments) => {
     stream.send(content, attachments);
   }, [stream]);
   return {
@@ -7791,5 +7925,5 @@ export {
   AIStreamProvider
 };
 
-//# debugId=AB794411AE9A001D64756E2164756E21
+//# debugId=D69799996BCD92A364756E2164756E21
 //# sourceMappingURL=index.js.map