@absolutejs/absolute 0.19.0-beta.527 → 0.19.0-beta.529

package/dist/types/ai.d.ts

@@ -99,6 +99,7 @@ export type RAGRetrievedState = {
     retrievalStartedAt?: number;
     retrievedAt?: number;
     retrievalDurationMs?: number;
+    trace?: RAGRetrievalTrace;
     sources: RAGSource[];
     sourceGroups: RAGSourceGroup[];
     sourceSummaries: RAGSourceSummary[];
@@ -479,7 +480,47 @@ export type RAGCollectionSearchParams = {
     model?: string;
     signal?: AbortSignal;
 };
-export type RAGSearchRequest = Omit<RAGCollectionSearchParams, 'signal' | 'rerank'>;
+export type RAGRetrievalTraceStage = 'input' | 'query_transform' | 'embed' | 'vector_search' | 'lexical_search' | 'fusion' | 'rerank' | 'score_filter' | 'finalize';
+export type RAGRetrievalTraceStep = {
+    stage: RAGRetrievalTraceStage;
+    label: string;
+    durationMs?: number;
+    count?: number;
+    metadata?: Record<string, string | number | boolean | null>;
+};
+export type RAGRetrievalTrace = {
+    query: string;
+    transformedQuery: string;
+    variantQueries: string[];
+    topK: number;
+    candidateTopK: number;
+    lexicalTopK: number;
+    mode: RAGHybridRetrievalMode;
+    runVector: boolean;
+    runLexical: boolean;
+    scoreThreshold?: number;
+    resultCounts: {
+        vector: number;
+        lexical: number;
+        fused: number;
+        reranked: number;
+        final: number;
+    };
+    steps: RAGRetrievalTraceStep[];
+};
+export type RAGCollectionSearchResult = {
+    results: RAGQueryResult[];
+    trace: RAGRetrievalTrace;
+};
+export type RAGSearchRequest = Omit<RAGCollectionSearchParams, 'signal' | 'rerank'> & {
+    includeTrace?: boolean;
+};
+export type RAGSearchResponse = {
+    ok: boolean;
+    results?: RAGSource[];
+    trace?: RAGRetrievalTrace;
+    error?: string;
+};
 export type RAGIngestResponse = {
     ok: boolean;
     count?: number;
@@ -1261,6 +1302,7 @@ export type RAGRetrievalComparison = {
 export type RAGCollection = {
     store: RAGVectorStore;
     search: (input: RAGCollectionSearchParams) => Promise<RAGQueryResult[]>;
+    searchWithTrace: (input: RAGCollectionSearchParams) => Promise<RAGCollectionSearchResult>;
     ingest: (input: RAGUpsertInput) => Promise<void>;
     clear?: () => Promise<void> | void;
     getStatus?: () => RAGVectorStoreStatus;
@@ -1491,6 +1533,7 @@ export type AIMessage = {
     retrievalStartedAt?: number;
     retrievedAt?: number;
     retrievalDurationMs?: number;
+    retrievalTrace?: RAGRetrievalTrace;
     durationMs?: number;
     timestamp: number;
 };
@@ -1702,6 +1745,7 @@ export type RAGChatPluginConfig = AIChatPluginConfig & {
     extractors?: RAGFileExtractor[];
     embedding?: RAGEmbeddingProviderLike;
     embeddingModel?: string;
+    readinessProviderName?: string;
     rerank?: RAGRerankerProviderLike;
     indexManager?: RAGIndexManager;
     topK?: number;

package/dist/vue/ai/index.js

@@ -1027,8 +1027,12 @@ var createRAGClient = (options) => {
       return parseJson(response);
     },
     async search(input) {
+      const result = await this.searchDetailed(input);
+      return result.results;
+    },
+    async searchDetailed(input) {
       const response = await fetchImpl(`${basePath}/search`, {
-        body: JSON.stringify(input),
+        body: JSON.stringify({ ...input, includeTrace: true }),
         headers: jsonHeaders,
         method: "POST"
       });
@@ -1039,7 +1043,10 @@ var createRAGClient = (options) => {
       if (!payload.ok) {
         throw new Error(payload.error ?? "RAG search failed");
       }
-      return payload.results ?? [];
+      return {
+        results: payload.results ?? [],
+        trace: payload.trace
+      };
     },
     async status() {
       const response = await fetchImpl(`${basePath}/status`);
@@ -1098,6 +1105,13 @@ var buildSourceGroupKey = (source) => source.source ?? source.title ?? source.ch
 var buildSourceLabel = (source) => source.source ?? source.title ?? source.chunkId;
 var getContextNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
 var getContextString = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+var isRAGRetrievalTrace = (value) => {
+  if (!value || typeof value !== "object") {
+    return false;
+  }
+  const candidate = value;
+  return typeof candidate.query === "string" && typeof candidate.transformedQuery === "string" && Array.isArray(candidate.variantQueries) && Array.isArray(candidate.steps);
+};
 var formatTimestampLabel = (value) => {
   const timestamp = typeof value === "number" && Number.isFinite(value) ? value : typeof value === "string" ? Date.parse(value) : Number.NaN;
   if (!Number.isFinite(timestamp)) {
@@ -1365,6 +1379,7 @@ var buildRAGRetrievedState = (messages) => {
     retrievalDurationMs: message.retrievalDurationMs,
     retrievalStartedAt: message.retrievalStartedAt,
     retrievedAt: message.retrievedAt,
+    trace: isRAGRetrievalTrace(message.retrievalTrace) ? message.retrievalTrace : undefined,
     sourceGroups: buildRAGSourceGroups(sources),
     sourceSummaries: buildRAGSourceSummaries(sources),
     sources
@@ -3274,5 +3289,5 @@ export {
   AIStreamKey
 };
 
-//# debugId=3DD3557C9D6FE70C64756E2164756E21
+//# debugId=4CD93E092D2A92E664756E2164756E21
 //# sourceMappingURL=index.js.map