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

package/dist/types/ai.d.ts

@@ -79,6 +79,18 @@ export type RAGGroundedAnswerCitationDetail = {
     evidenceLabel: string;
     evidenceSummary: string;
 };
+export type RAGGroundedAnswerSectionSummary = {
+    key: string;
+    label: string;
+    summary: string;
+    count: number;
+    chunkIds: string[];
+    referenceNumbers: number[];
+    references: RAGGroundingReference[];
+    contextLabel?: string;
+    locatorLabel?: string;
+    provenanceLabel?: string;
+};
 export type RAGGroundedAnswerPart = {
     type: 'text';
     text: string;
@@ -96,6 +108,7 @@ export type RAGGroundedAnswer = {
     coverage: 'grounded' | 'partial' | 'ungrounded';
     parts: RAGGroundedAnswerPart[];
     references: RAGGroundingReference[];
+    sectionSummaries: RAGGroundedAnswerSectionSummary[];
     ungroundedReferenceNumbers: number[];
 };
 export type RAGRetrievedState = {
@@ -453,7 +466,7 @@ export type RAGChunkGraphNode = {
 export type RAGChunkGraphEdge = {
     fromChunkId: string;
     toChunkId: string;
-    relation: 'previous' | 'next';
+    relation: 'previous' | 'next' | 'section_parent' | 'section_child';
 };
 export type RAGChunkGraphSectionGroup = {
     id: string;
@@ -463,6 +476,9 @@ export type RAGChunkGraphSectionGroup = {
     kind?: 'markdown_heading' | 'html_heading';
     chunkIds: string[];
     chunkCount: number;
+    leadChunkId?: string;
+    parentSectionId?: string;
+    childSectionIds: string[];
 };
 export type RAGChunkGraph = {
     nodes: RAGChunkGraphNode[];
@@ -475,6 +491,9 @@ export type RAGChunkGraphNavigation = {
     previousNode?: RAGChunkGraphNode;
     nextNode?: RAGChunkGraphNode;
     section?: RAGChunkGraphSectionGroup;
+    parentSection?: RAGChunkGraphSectionGroup;
+    childSections: RAGChunkGraphSectionGroup[];
+    siblingSections: RAGChunkGraphSectionGroup[];
     sectionNodes: RAGChunkGraphNode[];
 };
 export type RAGBackendDescriptor = {

package/dist/vue/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
   };
 };
@@ -6798,6 +6909,24 @@ var useRAGChunkPreview = (path) => {
   const selectChunk = (id) => {
     activeChunkId.value = id;
   };
+  const selectParentSection = () => {
+    const leadChunkId = navigation.value?.parentSection?.leadChunkId;
+    if (leadChunkId) {
+      activeChunkId.value = leadChunkId;
+    }
+  };
+  const selectChildSection = (sectionId) => {
+    const leadChunkId = navigation.value?.childSections.find((section) => section.id === sectionId)?.leadChunkId;
+    if (leadChunkId) {
+      activeChunkId.value = leadChunkId;
+    }
+  };
+  const selectSiblingSection = (sectionId) => {
+    const leadChunkId = navigation.value?.siblingSections.find((section) => section.id === sectionId)?.leadChunkId;
+    if (leadChunkId) {
+      activeChunkId.value = leadChunkId;
+    }
+  };
   return {
     activeChunkId,
     clear,
@@ -6807,7 +6936,10 @@ var useRAGChunkPreview = (path) => {
     isLoading,
     navigation,
     preview,
-    selectChunk
+    selectChildSection,
+    selectChunk,
+    selectParentSection,
+    selectSiblingSection
   };
 };
 // src/vue/ai/useRAG.ts
@@ -7379,11 +7511,13 @@ var useRAGSources = (messages) => {
   const chunkGraph = computed5(() => buildRAGChunkGraph(sources.value));
   const citationReferenceMap = computed5(() => buildRAGCitationReferenceMap(sourceSummaries.value.flatMap((summary) => summary.citations)));
   const hasSources = computed5(() => sources.value.length > 0);
+  const navigationForChunk = (chunkId) => buildRAGChunkGraphNavigation(chunkGraph.value, chunkId ?? undefined);
   return {
     citationReferenceMap,
     chunkGraph,
     hasSources,
     latestAssistantMessage,
+    navigationForChunk,
     sourceGroups,
     sources,
     sourceSummaries
@@ -7561,5 +7695,5 @@ export {
   AIStreamKey
 };
 
-//# debugId=8B2F93A7DA0F41AD64756E2164756E21
+//# debugId=6508AB216758DFE664756E2164756E21
 //# sourceMappingURL=index.js.map