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

package/dist/src/ai/client/ui.d.ts

@@ -1,5 +1,5 @@
 export { buildRAGAnswerWorkflowState, buildRAGSourceGroups, buildRAGSourceSummaries, buildRAGStreamProgress, getLatestAssistantMessage, resolveRAGStreamStage } from '../rag/workflowState';
 export { buildRAGStreamProgress as getRAGStreamProgress } from '../rag/workflowState';
-export { buildRAGCitationReferenceMap, buildRAGGroundedAnswer, buildRAGGroundingReferences } from '../rag/grounding';
+export { buildRAGCitationReferenceMap, buildRAGChunkGraphNavigation, buildRAGChunkGraph, buildRAGChunkPreviewGraph, buildRAGChunkPreviewNavigation, buildRAGGroundedAnswer, buildRAGGroundingReferences } from '../rag/presentation';
 export type { RAGStreamProgress, RAGStreamProgressState } from '../rag/workflowState';
 export type { RAGAnswerWorkflowState } from '../../../types/ai';

package/dist/src/ai/rag/index.d.ts

@@ -10,7 +10,7 @@ export { createRAGGmailEmailSyncClient, createRAGGraphEmailSyncClient, createRAG
 export { buildRAGUpsertInputFromDirectory, buildRAGUpsertInputFromDocuments, buildRAGUpsertInputFromUploads, createBuiltinArchiveExpander, createEmailExtractor, createEPUBExtractor, createLegacyDocumentExtractor, createRAGPDFOCRExtractor, createRAGArchiveExpander, createRAGArchiveFileExtractor, createOfficeDocumentExtractor, createPDFFileExtractor, createRAGFileExtractor, createRAGImageOCRExtractor, createRAGMediaFileExtractor, createRAGMediaTranscriber, createRAGOCRProvider, createTextFileExtractor, loadRAGDocumentFromURL, loadRAGDocumentUpload, loadRAGDocumentsFromUploads, buildRAGUpsertInputFromURLs, loadRAGDocumentFile, loadRAGDocumentsFromDirectory, loadRAGDocumentsFromURLs, prepareRAGDirectoryDocuments, prepareRAGDocument, prepareRAGDocumentFile, prepareRAGDocuments } from './ingestion';
 export { buildRAGContext } from './types';
 export { buildRAGEvaluationLeaderboard, buildRAGEvaluationResponse, compareRAGRetrievalStrategies, compareRAGRerankers, buildRAGAnswerGroundingCaseDifficultyLeaderboard, buildRAGAnswerGroundingCaseDifficultyRunDiff, buildRAGAnswerGroundingEvaluationLeaderboard, buildRAGAnswerGroundingEvaluationResponse, buildRAGAnswerGroundingEvaluationRunDiff, buildRAGRetrievalComparisonDecisionSummary, buildRAGRetrievalReleaseVerdict, createRAGFileAnswerGroundingCaseDifficultyHistoryStore, createRAGFileAnswerGroundingEvaluationHistoryStore, createRAGFileEvaluationHistoryStore, createRAGFileRetrievalBaselineStore, createRAGFileRetrievalComparisonHistoryStore, createRAGFileRetrievalLaneHandoffDecisionStore, createRAGFileRetrievalLaneHandoffIncidentStore, createRAGFileRetrievalLaneHandoffIncidentHistoryStore, createRAGFileRetrievalIncidentRemediationDecisionStore, createRAGFileRetrievalIncidentRemediationExecutionHistoryStore, createRAGFileRetrievalLaneHandoffAutoCompletePolicyHistoryStore, createRAGFileRetrievalReleaseLanePolicyHistoryStore, createRAGFileRetrievalBaselineGatePolicyHistoryStore, createRAGFileRetrievalReleaseLaneEscalationPolicyHistoryStore, createRAGFileRetrievalReleaseDecisionStore, createRAGFileRetrievalReleaseIncidentStore, createRAGFileSearchTraceStore, createRAGFileSearchTracePruneHistoryStore, createRAGSQLiteSearchTraceStore, createRAGEvaluationSuite, evaluateRAGAnswerGrounding, evaluateRAGAnswerGroundingCase, evaluateRAGCollection, executeDryRunRAGEvaluation, loadRAGAnswerGroundingCaseDifficultyHistory, loadRAGAnswerGroundingEvaluationHistory, loadRAGEvaluationHistory, loadRAGRetrievalBaselines, loadRAGRetrievalComparisonHistory, loadRAGRetrievalLaneHandoffDecisions, loadRAGRetrievalLaneHandoffIncidents, loadRAGRetrievalLaneHandoffIncidentHistory, loadRAGRetrievalIncidentRemediationDecisions, loadRAGRetrievalIncidentRemediationExecutionHistory, loadRAGRetrievalLaneHandoffAutoCompletePolicyHistory, loadRAGRetrievalReleaseLanePolicyHistory, loadRAGRetrievalBaselineGatePolicyHistory, loadRAGRetrievalReleaseLaneEscalationPolicyHistory, loadRAGRetrievalReleaseDecisions, loadRAGRetrievalReleaseIncidents, loadRAGSearchTraceGroupHistory, loadRAGSearchTraceHistory, loadRAGSearchTracePruneHistory, previewRAGSearchTraceStorePrune, persistRAGRetrievalBaseline, persistRAGRetrievalComparisonRun, persistRAGRetrievalLaneHandoffDecision, persistRAGRetrievalLaneHandoffIncident, persistRAGRetrievalLaneHandoffIncidentHistory, persistRAGRetrievalIncidentRemediationDecision, persistRAGRetrievalIncidentRemediationExecutionHistory, persistRAGRetrievalLaneHandoffAutoCompletePolicyHistory, persistRAGRetrievalReleaseLanePolicyHistory, persistRAGRetrievalBaselineGatePolicyHistory, persistRAGRetrievalReleaseLaneEscalationPolicyHistory, persistRAGRetrievalReleaseDecision, persistRAGRetrievalReleaseIncident, persistRAGSearchTracePruneRun, pruneRAGSearchTraceStore, summarizeRAGSearchTraceStore, buildRAGRetrievalTraceHistoryTrend, persistRAGAnswerGroundingCaseDifficultyRun, persistRAGAnswerGroundingEvaluationRun, persistRAGEvaluationSuiteRun, persistRAGSearchTraceRecord, runRAGEvaluationSuite, summarizeRAGEvaluationCase, summarizeRAGRerankerComparison, compareRAGRetrievalTraceSummaries, summarizeRAGRetrievalTraces, buildRAGEvaluationRunDiff, buildRAGSearchTraceDiff, buildRAGSearchTraceRecord } from './quality';
-export { buildRAGAdminActionPresentation, buildRAGAdminActionPresentations, buildRAGAdminJobPresentation, buildRAGAdminJobPresentations, buildRAGAnswerGroundingCaseSnapshotPresentations, buildRAGAnswerGroundingHistoryPresentation, buildRAGAnswerGroundingHistoryRows, buildRAGCitations, buildRAGCitationReferenceMap, buildRAGComparisonTraceDiffRows, buildRAGComparisonTraceSummaryRows, buildRAGCorpusHealthPresentation, buildRAGEvaluationCaseTracePresentations, buildRAGEvaluationHistoryPresentation, buildRAGEvaluationHistoryRows, buildRAGGroundedAnswer, buildRAGGroundingOverviewPresentation, buildRAGGroundingProviderCaseComparisonPresentations, buildRAGGroundingProviderOverviewPresentation, buildRAGGroundingProviderPresentations, buildRAGGroundingReferences, buildRAGQualityOverviewPresentation, buildRAGReadinessPresentation, buildRAGRerankerComparisonOverviewPresentation, buildRAGRerankerComparisonPresentations, buildRAGRerankerOverviewPresentation, buildRAGRetrievalComparisonOverviewPresentation, buildRAGRetrievalComparisonPresentations, buildRAGRetrievalOverviewPresentation, buildRAGRetrievalTracePresentation, buildRAGSourceGroups, buildRAGSourceSummaries, buildRAGSyncOverviewPresentation, buildRAGSyncSourcePresentation, buildRAGSyncSourcePresentations } from './ui';
+export { buildRAGAdminActionPresentation, buildRAGAdminActionPresentations, buildRAGAdminJobPresentation, buildRAGAdminJobPresentations, buildRAGAnswerGroundingCaseSnapshotPresentations, buildRAGAnswerGroundingHistoryPresentation, buildRAGAnswerGroundingHistoryRows, buildRAGCitations, buildRAGCitationReferenceMap, buildRAGChunkGraphNavigation, buildRAGChunkPreviewGraph, buildRAGChunkPreviewNavigation, buildRAGChunkGraph, buildRAGComparisonTraceDiffRows, buildRAGComparisonTraceSummaryRows, buildRAGCorpusHealthPresentation, buildRAGEvaluationCaseTracePresentations, buildRAGEvaluationHistoryPresentation, buildRAGEvaluationHistoryRows, buildRAGGroundedAnswer, buildRAGGroundingOverviewPresentation, buildRAGGroundingProviderCaseComparisonPresentations, buildRAGGroundingProviderOverviewPresentation, buildRAGGroundingProviderPresentations, buildRAGGroundingReferences, buildRAGQualityOverviewPresentation, buildRAGReadinessPresentation, buildRAGRerankerComparisonOverviewPresentation, buildRAGRerankerComparisonPresentations, buildRAGRerankerOverviewPresentation, buildRAGRetrievalComparisonOverviewPresentation, buildRAGRetrievalComparisonPresentations, buildRAGRetrievalOverviewPresentation, buildRAGRetrievalTracePresentation, buildRAGSourceGroups, buildRAGSourceSummaries, buildRAGSyncOverviewPresentation, buildRAGSyncSourcePresentation, buildRAGSyncSourcePresentations } from './ui';
 export { createRAGBunS3SyncClient, createRAGDirectorySyncSource, createRAGEmailSyncSource, createRAGFileSyncStateStore, createRAGStaticEmailSyncClient, createRAGStorageSyncSource, createRAGSyncManager, createRAGSyncScheduler, createRAGUrlSyncSource } from './sync';
 export { createRAGCollection, ingestDocuments, ingestRAGDocuments, searchDocuments } from './collection';
 export { createInMemoryRAGStore } from './adapters/inMemory';

package/dist/src/ai/rag/presentation.d.ts

@@ -1,4 +1,4 @@
-import type { RAGAdminActionPresentation, RAGAdminActionRecord, RAGAdminJobPresentation, RAGAdminJobRecord, AIMessage, RAGAnswerGroundingCaseSnapshotPresentation, RAGAnswerGroundingEvaluationHistory, RAGAnswerGroundingEvaluationResponse, RAGCorpusHealth, RAGCorpusHealthPresentation, RAGExtractorReadiness, RAGReadinessPresentation, RAGGroundingOverviewPresentation, RAGGroundingProviderCaseComparisonPresentation, RAGGroundingProviderOverviewPresentation, RAGGroundingProviderPresentation, RAGComparisonOverviewPresentation, RAGComparisonPresentation, RAGLabelValueRow, RAGRerankerComparisonEntry, RAGRetrievalComparison, RAGRetrievalComparisonEntry, RAGRetrievalTrace, RAGQualityOverviewPresentation, RAGEvaluationCaseTracePresentation, RAGEvaluationHistory, RAGAnswerGroundingHistoryPresentation, RAGEvaluationHistoryPresentation, RAGRerankerComparison, RAGAnswerWorkflowState, RAGRetrievalTracePresentation, RAGSource, RAGSourceLabels, RAGSourceGroup, RAGSourceSummary, RAGStreamStage, RAGSyncOverviewPresentation, RAGSyncSourcePresentation, RAGSyncSourceRecord } from '../../../types/ai';
+import type { RAGAdminActionPresentation, RAGAdminActionRecord, RAGAdminJobPresentation, RAGAdminJobRecord, AIMessage, RAGAnswerGroundingCaseSnapshotPresentation, RAGAnswerGroundingEvaluationHistory, RAGAnswerGroundingEvaluationResponse, RAGCorpusHealth, RAGCorpusHealthPresentation, RAGExtractorReadiness, RAGReadinessPresentation, RAGGroundingOverviewPresentation, RAGGroundingProviderCaseComparisonPresentation, RAGGroundingProviderOverviewPresentation, RAGGroundingProviderPresentation, RAGComparisonOverviewPresentation, RAGComparisonPresentation, RAGChunkGraph, RAGChunkGraphNavigation, RAGChunkStructure, RAGDocumentChunkPreview, RAGLabelValueRow, RAGRerankerComparisonEntry, RAGRetrievalComparison, RAGRetrievalComparisonEntry, RAGRetrievalTrace, RAGQualityOverviewPresentation, RAGEvaluationCaseTracePresentation, RAGEvaluationHistory, RAGAnswerGroundingHistoryPresentation, RAGEvaluationHistoryPresentation, RAGRerankerComparison, RAGAnswerWorkflowState, RAGRetrievalTracePresentation, RAGSource, RAGSourceLabels, RAGSourceGroup, RAGSourceSummary, RAGStreamStage, RAGSyncOverviewPresentation, RAGSyncSourcePresentation, RAGSyncSourceRecord } from '../../../types/ai';
 import { buildRAGCitationReferenceMap, buildRAGCitations, buildRAGGroundedAnswer, buildRAGGroundingReferences } from './grounding';
 export { buildRAGCitationReferenceMap, buildRAGCitations, buildRAGGroundedAnswer, buildRAGGroundingReferences };
 export declare const buildRAGRetrievalTracePresentation: (trace?: RAGRetrievalTrace) => RAGRetrievalTracePresentation;
@@ -16,6 +16,12 @@ export declare const buildRAGSourceLabels: ({ metadata, source, title }: {
     source?: string;
     title?: string;
 }) => RAGSourceLabels | undefined;
+export declare const buildRAGChunkStructure: (metadata?: Record<string, unknown>) => RAGChunkStructure | undefined;
+type GraphChunkInput = Pick<RAGSource, 'chunkId' | 'metadata' | 'source' | 'title' | 'labels' | 'structure'> & Partial<Pick<RAGSource, 'score'>>;
+export declare const buildRAGChunkGraph: (chunks: GraphChunkInput[]) => RAGChunkGraph;
+export declare const buildRAGChunkPreviewGraph: (preview: Pick<RAGDocumentChunkPreview, "chunks" | "document">) => RAGChunkGraph;
+export declare const buildRAGChunkPreviewNavigation: (preview: Pick<RAGDocumentChunkPreview, "chunks" | "document">, activeChunkId?: string) => RAGChunkGraphNavigation;
+export declare const buildRAGChunkGraphNavigation: (graph: RAGChunkGraph, activeChunkId?: string) => RAGChunkGraphNavigation;
 export declare const buildRAGRetrievedState: (messages: AIMessage[]) => {
     citationReferenceMap: import("./types").RAGCitationReferenceMap;
     citations: import("./types").RAGCitation[];

package/dist/src/ai/rag/ui.d.ts

@@ -1,4 +1,4 @@
-export { buildRAGAdminActionPresentation, buildRAGAdminActionPresentations, buildRAGAdminJobPresentation, buildRAGAdminJobPresentations, buildRAGCitations, buildRAGCitationReferenceMap, buildRAGCorpusHealthPresentation, buildRAGGroundedAnswer, buildRAGGroundingReferences, buildRAGReadinessPresentation, buildRAGRetrievalTracePresentation, buildRAGSyncOverviewPresentation, buildRAGSyncSourcePresentation, buildRAGSyncSourcePresentations } from './presentation';
+export { buildRAGAdminActionPresentation, buildRAGAdminActionPresentations, buildRAGAdminJobPresentation, buildRAGAdminJobPresentations, buildRAGCitations, buildRAGCitationReferenceMap, buildRAGChunkGraphNavigation, buildRAGChunkPreviewGraph, buildRAGChunkPreviewNavigation, buildRAGChunkGraph, buildRAGCorpusHealthPresentation, buildRAGGroundedAnswer, buildRAGGroundingReferences, buildRAGReadinessPresentation, buildRAGRetrievalTracePresentation, buildRAGSyncOverviewPresentation, buildRAGSyncSourcePresentation, buildRAGSyncSourcePresentations } from './presentation';
 export { buildRAGAnswerWorkflowState, buildRAGRetrievedState, buildRAGSourceGroups, buildRAGSourceSummaries, buildRAGStreamProgress, getLatestAssistantMessage, getLatestRAGSources, resolveRAGStreamStage } from './workflowState';
 export { buildRAGAnswerGroundingCaseSnapshotPresentations, buildRAGAnswerGroundingHistoryPresentation, buildRAGAnswerGroundingHistoryRows, buildRAGComparisonTraceDiffRows, buildRAGComparisonTraceSummaryRows, buildRAGQualityOverviewPresentation, buildRAGGroundingOverviewPresentation, buildRAGGroundingProviderCaseComparisonPresentations, buildRAGGroundingProviderOverviewPresentation, buildRAGGroundingProviderPresentations, buildRAGRetrievalComparisonOverviewPresentation, buildRAGRetrievalOverviewPresentation, buildRAGRetrievalComparisonPresentations, buildRAGRerankerComparisonOverviewPresentation, buildRAGRerankerOverviewPresentation, buildRAGRerankerComparisonPresentations, buildRAGEvaluationCaseTracePresentations, buildRAGEvaluationHistoryPresentation, buildRAGEvaluationHistoryRows } from './presentation';
 export type { RAGStreamProgress, RAGStreamProgressState } from './workflowState';

package/dist/src/react/ai/useRAG.d.ts

@@ -6,13 +6,17 @@ export type UseRAGOptions = {
 };
 export declare const useRAG: (path: string, options?: UseRAGOptions) => {
     chunkPreview: {
+        activeChunkId: string | null;
+        chunkGraph: import("../..").RAGChunkGraph | null;
         clear: () => void;
         error: string | null;
         inspect: (id: string) => Promise<{
             ok: true;
         } & import("../..").RAGDocumentChunkPreview>;
         isLoading: boolean;
+        navigation: import("../..").RAGChunkGraphNavigation | null;
         preview: import("../..").RAGDocumentChunkPreview | null;
+        selectChunk: (id: string | null) => void;
     };
     citations: {
         citationReferenceMap: import("../..").RAGCitationReferenceMap;
@@ -186,6 +190,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
     };
     sources: {
         citationReferenceMap: import("../..").RAGCitationReferenceMap;
+        chunkGraph: import("../..").RAGChunkGraph;
         hasSources: boolean;
         latestAssistantMessage: import("../..").AIMessage | undefined;
         sourceGroups: import("../..").RAGSourceGroup[];

package/dist/src/react/ai/useRAGChunkPreview.d.ts

@@ -1,11 +1,15 @@
 import type { RAGDocumentChunkPreview } from '../../../types/ai';
 export declare const useRAGChunkPreview: (path: string) => {
+    activeChunkId: string | null;
+    chunkGraph: import("../..").RAGChunkGraph | null;
     clear: () => void;
     error: string | null;
     inspect: (id: string) => Promise<{
         ok: true;
     } & RAGDocumentChunkPreview>;
     isLoading: boolean;
+    navigation: import("../..").RAGChunkGraphNavigation | null;
     preview: RAGDocumentChunkPreview | null;
+    selectChunk: (id: string | null) => void;
 };
 export type UseRAGChunkPreviewResult = ReturnType<typeof useRAGChunkPreview>;

package/dist/src/react/ai/useRAGSources.d.ts

@@ -1,6 +1,7 @@
 import type { AIMessage } from '../../../types/ai';
 export declare const useRAGSources: (messages: AIMessage[]) => {
     citationReferenceMap: import("../..").RAGCitationReferenceMap;
+    chunkGraph: import("../..").RAGChunkGraph;
     hasSources: boolean;
     latestAssistantMessage: AIMessage | undefined;
     sourceGroups: import("../..").RAGSourceGroup[];

package/dist/src/svelte/ai/createRAG.d.ts

@@ -6,13 +6,17 @@ export type CreateRAGOptions = {
 };
 export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
     chunkPreview: {
+        activeChunkId: import("svelte/store").Writable<string | null>;
         clear: () => void;
+        chunkGraph: import("svelte/store").Readable<import("../..").RAGChunkGraph | null>;
         error: import("svelte/store").Writable<string | null>;
         inspect: (id: string) => Promise<{
             ok: true;
         } & import("../..").RAGDocumentChunkPreview>;
         isLoading: import("svelte/store").Writable<boolean>;
+        navigation: import("svelte/store").Readable<import("../..").RAGChunkGraphNavigation | null>;
         preview: import("svelte/store").Writable<import("../..").RAGDocumentChunkPreview | null>;
+        selectChunk: (id: string | null) => void;
     };
     citations: {
         citationReferenceMap: import("svelte/store").Readable<import("../..").RAGCitationReferenceMap>;
@@ -187,6 +191,7 @@ export declare const createRAG: (path: string, options?: CreateRAGOptions) => {
     };
     sources: {
         citationReferenceMap: import("svelte/store").Readable<import("../..").RAGCitationReferenceMap>;
+        chunkGraph: import("svelte/store").Readable<import("../..").RAGChunkGraph>;
         hasSources: import("svelte/store").Readable<boolean>;
         latestAssistantMessage: import("svelte/store").Readable<import("../..").AIMessage | undefined>;
         sourceGroups: import("svelte/store").Readable<import("../..").RAGSourceGroup[]>;

package/dist/src/svelte/ai/createRAGChunkPreview.d.ts

@@ -1,11 +1,15 @@
 import type { RAGDocumentChunkPreview } from '../../../types/ai';
 export declare const createRAGChunkPreview: (path: string) => {
+    activeChunkId: import("svelte/store").Writable<string | null>;
     clear: () => void;
+    chunkGraph: import("svelte/store").Readable<import("../..").RAGChunkGraph | null>;
     error: import("svelte/store").Writable<string | null>;
     inspect: (id: string) => Promise<{
         ok: true;
     } & RAGDocumentChunkPreview>;
     isLoading: import("svelte/store").Writable<boolean>;
+    navigation: import("svelte/store").Readable<import("../..").RAGChunkGraphNavigation | null>;
     preview: import("svelte/store").Writable<RAGDocumentChunkPreview | null>;
+    selectChunk: (id: string | null) => void;
 };
 export type CreateRAGChunkPreviewResult = ReturnType<typeof createRAGChunkPreview>;

package/dist/src/svelte/ai/createRAGSources.d.ts

@@ -2,6 +2,7 @@ import { type Readable } from 'svelte/store';
 import type { AIMessage } from '../../../types/ai';
 export declare const createRAGSources: (messages: Readable<AIMessage[]>) => {
     citationReferenceMap: Readable<import("../..").RAGCitationReferenceMap>;
+    chunkGraph: Readable<import("../..").RAGChunkGraph>;
     hasSources: Readable<boolean>;
     latestAssistantMessage: Readable<AIMessage | undefined>;
     sourceGroups: Readable<import("../..").RAGSourceGroup[]>;

package/dist/src/vue/ai/useRAG.d.ts

@@ -6,12 +6,15 @@ export type UseRAGOptions = {
 };
 export declare const useRAG: (path: string, options?: UseRAGOptions) => {
     chunkPreview: {
+        activeChunkId: import("vue").Ref<string | null, string | null>;
         clear: () => void;
+        chunkGraph: import("vue").ComputedRef<import("../..").RAGChunkGraph | null>;
         error: import("vue").Ref<string | null, string | null>;
         inspect: (id: string) => Promise<{
             ok: true;
         } & import("../..").RAGDocumentChunkPreview>;
         isLoading: import("vue").Ref<boolean, boolean>;
+        navigation: import("vue").ComputedRef<import("../..").RAGChunkGraphNavigation | null>;
         preview: import("vue").Ref<{
             document: {
                 source: string;
@@ -39,6 +42,21 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 source?: string | undefined;
                 metadata?: Record<string, unknown> | undefined;
                 embedding?: number[] | undefined;
+                structure?: {
+                    section?: {
+                        title?: string | undefined;
+                        path?: string[] | undefined;
+                        depth?: number | undefined;
+                        kind?: "markdown_heading" | "html_heading" | undefined;
+                    } | undefined;
+                    sequence?: {
+                        sectionChunkId?: string | undefined;
+                        sectionChunkIndex?: number | undefined;
+                        sectionChunkCount?: number | undefined;
+                        previousChunkId?: string | undefined;
+                        nextChunkId?: string | undefined;
+                    } | undefined;
+                } | undefined;
                 labels?: {
                     contextLabel?: string | undefined;
                     locatorLabel?: string | undefined;
@@ -72,6 +90,21 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 source?: string | undefined;
                 metadata?: Record<string, unknown> | undefined;
                 embedding?: number[] | undefined;
+                structure?: {
+                    section?: {
+                        title?: string | undefined;
+                        path?: string[] | undefined;
+                        depth?: number | undefined;
+                        kind?: "markdown_heading" | "html_heading" | undefined;
+                    } | undefined;
+                    sequence?: {
+                        sectionChunkId?: string | undefined;
+                        sectionChunkIndex?: number | undefined;
+                        sectionChunkCount?: number | undefined;
+                        previousChunkId?: string | undefined;
+                        nextChunkId?: string | undefined;
+                    } | undefined;
+                } | undefined;
                 labels?: {
                     contextLabel?: string | undefined;
                     locatorLabel?: string | undefined;
@@ -79,6 +112,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 } | undefined;
             }[];
         } | null>;
+        selectChunk: (id: string | null) => void;
     };
     citations: {
         citationReferenceMap: import("vue").ComputedRef<import("../..").RAGCitationReferenceMap>;
@@ -1318,6 +1352,21 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 locatorLabel?: string | undefined;
                 provenanceLabel?: string | undefined;
             } | undefined;
+            structure?: {
+                section?: {
+                    title?: string | undefined;
+                    path?: string[] | undefined;
+                    depth?: number | undefined;
+                    kind?: "markdown_heading" | "html_heading" | undefined;
+                } | undefined;
+                sequence?: {
+                    sectionChunkId?: string | undefined;
+                    sectionChunkIndex?: number | undefined;
+                    sectionChunkCount?: number | undefined;
+                    previousChunkId?: string | undefined;
+                    nextChunkId?: string | undefined;
+                } | undefined;
+            } | undefined;
         }[], import("../..").RAGSource[] | {
             chunkId: string;
             score: number;
@@ -1330,6 +1379,21 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
                 locatorLabel?: string | undefined;
                 provenanceLabel?: string | undefined;
             } | undefined;
+            structure?: {
+                section?: {
+                    title?: string | undefined;
+                    path?: string[] | undefined;
+                    depth?: number | undefined;
+                    kind?: "markdown_heading" | "html_heading" | undefined;
+                } | undefined;
+                sequence?: {
+                    sectionChunkId?: string | undefined;
+                    sectionChunkIndex?: number | undefined;
+                    sectionChunkCount?: number | undefined;
+                    previousChunkId?: string | undefined;
+                    nextChunkId?: string | undefined;
+                } | undefined;
+            } | undefined;
         }[]>;
         search: (input: {
             filter?: Record<string, unknown> | undefined;
@@ -1361,6 +1425,7 @@ export declare const useRAG: (path: string, options?: UseRAGOptions) => {
     };
     sources: {
         citationReferenceMap: import("vue").ComputedRef<import("../..").RAGCitationReferenceMap>;
+        chunkGraph: import("vue").ComputedRef<import("../..").RAGChunkGraph>;
         hasSources: import("vue").ComputedRef<boolean>;
         latestAssistantMessage: import("vue").ComputedRef<import("../..").AIMessage | undefined>;
         sourceGroups: import("vue").ComputedRef<import("../..").RAGSourceGroup[]>;

package/dist/src/vue/ai/useRAGChunkPreview.d.ts

@@ -1,11 +1,14 @@
 import type { RAGDocumentChunkPreview } from '../../../types/ai';
 export declare const useRAGChunkPreview: (path: string) => {
+    activeChunkId: import("vue").Ref<string | null, string | null>;
     clear: () => void;
+    chunkGraph: import("vue").ComputedRef<import("../..").RAGChunkGraph | null>;
     error: import("vue").Ref<string | null, string | null>;
     inspect: (id: string) => Promise<{
         ok: true;
     } & RAGDocumentChunkPreview>;
     isLoading: import("vue").Ref<boolean, boolean>;
+    navigation: import("vue").ComputedRef<import("../..").RAGChunkGraphNavigation | null>;
     preview: import("vue").Ref<{
         document: {
             source: string;
@@ -33,6 +36,21 @@ export declare const useRAGChunkPreview: (path: string) => {
             source?: string | undefined;
             metadata?: Record<string, unknown> | undefined;
             embedding?: number[] | undefined;
+            structure?: {
+                section?: {
+                    title?: string | undefined;
+                    path?: string[] | undefined;
+                    depth?: number | undefined;
+                    kind?: "markdown_heading" | "html_heading" | undefined;
+                } | undefined;
+                sequence?: {
+                    sectionChunkId?: string | undefined;
+                    sectionChunkIndex?: number | undefined;
+                    sectionChunkCount?: number | undefined;
+                    previousChunkId?: string | undefined;
+                    nextChunkId?: string | undefined;
+                } | undefined;
+            } | undefined;
             labels?: {
                 contextLabel?: string | undefined;
                 locatorLabel?: string | undefined;
@@ -66,6 +84,21 @@ export declare const useRAGChunkPreview: (path: string) => {
             source?: string | undefined;
             metadata?: Record<string, unknown> | undefined;
             embedding?: number[] | undefined;
+            structure?: {
+                section?: {
+                    title?: string | undefined;
+                    path?: string[] | undefined;
+                    depth?: number | undefined;
+                    kind?: "markdown_heading" | "html_heading" | undefined;
+                } | undefined;
+                sequence?: {
+                    sectionChunkId?: string | undefined;
+                    sectionChunkIndex?: number | undefined;
+                    sectionChunkCount?: number | undefined;
+                    previousChunkId?: string | undefined;
+                    nextChunkId?: string | undefined;
+                } | undefined;
+            } | undefined;
             labels?: {
                 contextLabel?: string | undefined;
                 locatorLabel?: string | undefined;
@@ -73,5 +106,6 @@ export declare const useRAGChunkPreview: (path: string) => {
             } | undefined;
         }[];
     } | null>;
+    selectChunk: (id: string | null) => void;
 };
 export type UseRAGChunkPreviewResult = ReturnType<typeof useRAGChunkPreview>;

package/dist/src/vue/ai/useRAGSearch.d.ts

@@ -75,6 +75,21 @@ export declare const useRAGSearch: (path: string) => {
             locatorLabel?: string | undefined;
             provenanceLabel?: string | undefined;
         } | undefined;
+        structure?: {
+            section?: {
+                title?: string | undefined;
+                path?: string[] | undefined;
+                depth?: number | undefined;
+                kind?: "markdown_heading" | "html_heading" | undefined;
+            } | undefined;
+            sequence?: {
+                sectionChunkId?: string | undefined;
+                sectionChunkIndex?: number | undefined;
+                sectionChunkCount?: number | undefined;
+                previousChunkId?: string | undefined;
+                nextChunkId?: string | undefined;
+            } | undefined;
+        } | undefined;
     }[], RAGSource[] | {
         chunkId: string;
         score: number;
@@ -87,6 +102,21 @@ export declare const useRAGSearch: (path: string) => {
             locatorLabel?: string | undefined;
             provenanceLabel?: string | undefined;
         } | undefined;
+        structure?: {
+            section?: {
+                title?: string | undefined;
+                path?: string[] | undefined;
+                depth?: number | undefined;
+                kind?: "markdown_heading" | "html_heading" | undefined;
+            } | undefined;
+            sequence?: {
+                sectionChunkId?: string | undefined;
+                sectionChunkIndex?: number | undefined;
+                sectionChunkCount?: number | undefined;
+                previousChunkId?: string | undefined;
+                nextChunkId?: string | undefined;
+            } | undefined;
+        } | undefined;
     }[]>;
     search: (input: SearchRequest) => Promise<RAGSource[]>;
     searchWithTrace: (input: SearchRequest) => Promise<RAGDetailedSearchResponse>;

package/dist/src/vue/ai/useRAGSources.d.ts

@@ -2,6 +2,7 @@ import { type Ref } from 'vue';
 import type { AIMessage } from '../../../types/ai';
 export declare const useRAGSources: (messages: Ref<AIMessage[]>) => {
     citationReferenceMap: import("vue").ComputedRef<import("../..").RAGCitationReferenceMap>;
+    chunkGraph: import("vue").ComputedRef<import("../..").RAGChunkGraph>;
     hasSources: import("vue").ComputedRef<boolean>;
     latestAssistantMessage: import("vue").ComputedRef<AIMessage | undefined>;
     sourceGroups: import("vue").ComputedRef<import("../..").RAGSourceGroup[]>;