@absolutejs/absolute 0.19.0-beta.433 → 0.19.0-beta.434

package/dist/ai-client/react/ai/index.js

@@ -629,8 +629,115 @@ var useAIStream = (path, conversationId) => {
     send
   };
 };
+// src/react/ai/useRAG.ts
+import { useMemo as useMemo7 } from "react";
+
+// src/react/ai/useRAGCitations.ts
+import { useMemo } from "react";
+
+// src/ai/rag/presentation.ts
+var buildSourceGroupKey = (source) => source.source ?? source.title ?? source.chunkId;
+var buildSourceLabel = (source) => source.source ?? source.title ?? source.chunkId;
+var getLatestAssistantMessage = (messages) => {
+  for (let index = messages.length - 1;index >= 0; index -= 1) {
+    const message = messages[index];
+    if (message?.role === "assistant") {
+      return message;
+    }
+  }
+  return;
+};
+var getLatestRAGSources = (messages) => getLatestAssistantMessage(messages)?.sources ?? [];
+var buildRAGSourceGroups = (sources) => {
+  const groups = new Map;
+  for (const source of sources) {
+    const key = buildSourceGroupKey(source);
+    const existing = groups.get(key);
+    if (existing) {
+      existing.bestScore = Math.max(existing.bestScore, source.score);
+      existing.count += 1;
+      existing.chunks.push(source);
+      continue;
+    }
+    groups.set(key, {
+      bestScore: source.score,
+      chunks: [source],
+      count: 1,
+      key,
+      label: buildSourceLabel(source),
+      source: source.source,
+      title: source.title
+    });
+  }
+  return [...groups.values()].sort((left, right) => {
+    if (right.bestScore !== left.bestScore) {
+      return right.bestScore - left.bestScore;
+    }
+    return left.label.localeCompare(right.label);
+  });
+};
+var buildRAGCitations = (sources) => {
+  const unique = new Map;
+  for (const source of sources) {
+    const key = source.chunkId;
+    const existing = unique.get(key);
+    if (existing && existing.score >= source.score) {
+      continue;
+    }
+    unique.set(key, {
+      chunkId: source.chunkId,
+      key,
+      label: buildSourceLabel(source),
+      metadata: source.metadata,
+      score: source.score,
+      source: source.source,
+      text: source.text,
+      title: source.title
+    });
+  }
+  return [...unique.values()].sort((left, right) => {
+    if (right.score !== left.score) {
+      return right.score - left.score;
+    }
+    return left.label.localeCompare(right.label);
+  });
+};
+var resolveRAGStreamStage = ({
+  error,
+  isStreaming,
+  messages
+}) => {
+  if (error) {
+    return "error";
+  }
+  const assistantMessage = getLatestAssistantMessage(messages);
+  if (!assistantMessage) {
+    return isStreaming ? "submitting" : "idle";
+  }
+  if (!isStreaming) {
+    return "complete";
+  }
+  const hasSources = (assistantMessage.sources?.length ?? 0) > 0;
+  const hasContent = assistantMessage.content.trim().length > 0 || assistantMessage.thinking?.trim().length || (assistantMessage.toolCalls?.length ?? 0) > 0 || (assistantMessage.images?.length ?? 0) > 0;
+  if (hasSources && !hasContent) {
+    return "retrieved";
+  }
+  return "streaming";
+};
+
+// src/react/ai/useRAGCitations.ts
+var useRAGCitations = (sources) => {
+  const citations = useMemo(() => buildRAGCitations(sources), [sources]);
+  const sourceGroups = useMemo(() => buildRAGSourceGroups(sources), [sources]);
+  return {
+    citations,
+    hasCitations: citations.length > 0,
+    sourceGroups
+  };
+};
+
 // src/react/ai/useRAGIngest.ts
-import { useCallback as useCallback2, useMemo, useState } from "react";
+import { useCallback as useCallback2, useMemo as useMemo2, useState } from "react";
 
 // src/ai/client/ragClient.ts
 var jsonHeaders = {
@@ -718,11 +825,13 @@ var createRAGClient = (options) => {
 
 // src/react/ai/useRAGIngest.ts
 var useRAGIngest = (path) => {
-  const client = useMemo(() => createRAGClient({ path }), [path]);
+  const client = useMemo2(() => createRAGClient({ path }), [path]);
   const [error, setError] = useState(null);
   const [isIngesting, setIsIngesting] = useState(false);
   const [lastIngestCount, setLastIngestCount] = useState(null);
-  const ingest = useCallback2(async (chunks) => {
+  const [lastDocumentCount, setLastDocumentCount] = useState(null);
+  const [lastResponse, setLastResponse] = useState(null);
+  const ingestChunks = useCallback2(async (chunks) => {
     setIsIngesting(true);
     setError(null);
     try {
@@ -731,6 +840,8 @@ var useRAGIngest = (path) => {
         throw new Error(response.error ?? "RAG ingest failed");
       }
       setLastIngestCount(response.count ?? chunks.length);
+      setLastDocumentCount(null);
+      setLastResponse(response);
       return response;
     } catch (caught) {
       const message = caught instanceof Error ? caught.message : String(caught);
@@ -740,26 +851,79 @@ var useRAGIngest = (path) => {
       setIsIngesting(false);
     }
   }, [client]);
+  const ingestDocuments = useCallback2(async (input) => {
+    setIsIngesting(true);
+    setError(null);
+    try {
+      const response = await client.ingestDocuments(input);
+      if (!response.ok) {
+        throw new Error(response.error ?? "RAG ingest failed");
+      }
+      setLastIngestCount(response.count ?? null);
+      setLastDocumentCount(response.documentCount ?? input.documents.length);
+      setLastResponse(response);
+      return response;
+    } catch (caught) {
+      const message = caught instanceof Error ? caught.message : String(caught);
+      setError(message);
+      throw caught;
+    } finally {
+      setIsIngesting(false);
+    }
+  }, [client]);
+  const clearIndex = useCallback2(async () => {
+    setIsIngesting(true);
+    setError(null);
+    try {
+      await client.clearIndex();
+      setLastIngestCount(0);
+      setLastDocumentCount(0);
+      setLastResponse(null);
+    } catch (caught) {
+      const message = caught instanceof Error ? caught.message : String(caught);
+      setError(message);
+      throw caught;
+    } finally {
+      setIsIngesting(false);
+    }
+  }, [client]);
+  const reset = useCallback2(() => {
+    setError(null);
+    setLastDocumentCount(null);
+    setLastIngestCount(null);
+    setLastResponse(null);
+  }, []);
   return {
+    clearIndex,
     error,
-    ingest,
+    ingest: ingestChunks,
+    ingestChunks,
+    ingestDocuments,
     isIngesting,
-    lastIngestCount
+    lastDocumentCount,
+    lastIngestCount,
+    lastResponse,
+    reset
   };
 };
+
 // src/react/ai/useRAGSearch.ts
-import { useCallback as useCallback3, useMemo as useMemo2, useState as useState2 } from "react";
+import { useCallback as useCallback3, useMemo as useMemo3, useState as useState2 } from "react";
 var useRAGSearch = (path) => {
-  const client = useMemo2(() => createRAGClient({ path }), [path]);
+  const client = useMemo3(() => createRAGClient({ path }), [path]);
   const [results, setResults] = useState2([]);
   const [error, setError] = useState2(null);
   const [isSearching, setIsSearching] = useState2(false);
+  const [hasSearched, setHasSearched] = useState2(false);
+  const [lastRequest, setLastRequest] = useState2(null);
   const search = useCallback3(async (input) => {
     setIsSearching(true);
     setError(null);
+    setLastRequest(input);
     try {
       const nextResults = await client.search(input);
       setResults(nextResults);
+      setHasSearched(true);
       return nextResults;
     } catch (caught) {
       const message = caught instanceof Error ? caught.message : String(caught);
@@ -769,18 +933,42 @@ var useRAGSearch = (path) => {
       setIsSearching(false);
     }
   }, [client]);
+  const reset = useCallback3(() => {
+    setError(null);
+    setHasSearched(false);
+    setLastRequest(null);
+    setResults([]);
+  }, []);
   return {
     error,
+    hasSearched,
     isSearching,
+    lastRequest,
+    reset,
     results,
     search,
     setResults
   };
 };
+
+// src/react/ai/useRAGSources.ts
+import { useMemo as useMemo4 } from "react";
+var useRAGSources = (messages) => {
+  const latestAssistantMessage = useMemo4(() => getLatestAssistantMessage(messages), [messages]);
+  const sources = useMemo4(() => getLatestRAGSources(messages), [messages]);
+  const sourceGroups = useMemo4(() => buildRAGSourceGroups(sources), [sources]);
+  return {
+    hasSources: sources.length > 0,
+    latestAssistantMessage,
+    sourceGroups,
+    sources
+  };
+};
+
 // src/react/ai/useRAGStatus.ts
-import { useCallback as useCallback4, useEffect as useEffect3, useMemo as useMemo3, useState as useState3 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect3, useMemo as useMemo5, useState as useState3 } from "react";
 var useRAGStatus = (path, autoLoad = true) => {
-  const client = useMemo3(() => createRAGClient({ path }), [path]);
+  const client = useMemo5(() => createRAGClient({ path }), [path]);
   const [status, setStatus] = useState3();
   const [capabilities, setCapabilities] = useState3();
   const [error, setError] = useState3(null);
@@ -801,6 +989,12 @@ var useRAGStatus = (path, autoLoad = true) => {
       setIsLoading(false);
     }
   }, [client]);
+  const reset = useCallback4(() => {
+    setCapabilities(undefined);
+    setError(null);
+    setIsLoading(false);
+    setStatus(undefined);
+  }, []);
   useEffect3(() => {
     if (!autoLoad) {
       setIsLoading(false);
@@ -813,16 +1007,64 @@ var useRAGStatus = (path, autoLoad = true) => {
     error,
     isLoading,
     refresh,
+    reset,
     status
   };
 };
+
 // src/react/ai/useRAGStream.ts
-var useRAGStream = useAIStream;
+import { useCallback as useCallback5, useMemo as useMemo6 } from "react";
+var useRAGStream = (path, conversationId) => {
+  const stream = useAIStream(path, conversationId);
+  const latestAssistantMessage = useMemo6(() => getLatestAssistantMessage(stream.messages), [stream.messages]);
+  const sources = useMemo6(() => getLatestRAGSources(stream.messages), [stream.messages]);
+  const sourceGroups = useMemo6(() => buildRAGSourceGroups(sources), [sources]);
+  const citations = useMemo6(() => buildRAGCitations(sources), [sources]);
+  const stage = useMemo6(() => resolveRAGStreamStage({
+    error: stream.error,
+    isStreaming: stream.isStreaming,
+    messages: stream.messages
+  }), [stream.error, stream.isStreaming, stream.messages]);
+  const query = useCallback5((content, attachments) => {
+    stream.send(content, attachments);
+  }, [stream]);
+  return {
+    ...stream,
+    citations,
+    hasSources: sources.length > 0,
+    latestAssistantMessage,
+    query,
+    sourceGroups,
+    sources,
+    stage
+  };
+};
+
+// src/react/ai/useRAG.ts
+var useRAG = (path, options = {}) => {
+  const search = useRAGSearch(path);
+  const ingest = useRAGIngest(path);
+  const status = useRAGStatus(path, options.autoLoadStatus ?? true);
+  const stream = useRAGStream(options.streamPath ?? path, options.conversationId);
+  const sources = useRAGSources(stream.messages);
+  const citations = useRAGCitations(sources.sources);
+  return useMemo7(() => ({
+    citations,
+    ingest,
+    search,
+    sources,
+    status,
+    stream
+  }), [citations, ingest, search, sources, status, stream]);
+};
 export {
   useRAGStream,
   useRAGStatus,
+  useRAGSources,
   useRAGSearch,
   useRAGIngest,
+  useRAGCitations,
+  useRAG,
   useAIStream,
   AIStreamProvider
 };

package/dist/react/ai/index.js

@@ -766,8 +766,115 @@ var useAIStream = (path, conversationId) => {
     send
   };
 };
+// src/react/ai/useRAG.ts
+import { useMemo as useMemo7 } from "react";
+
+// src/react/ai/useRAGCitations.ts
+import { useMemo } from "react";
+
+// src/ai/rag/presentation.ts
+var buildSourceGroupKey = (source) => source.source ?? source.title ?? source.chunkId;
+var buildSourceLabel = (source) => source.source ?? source.title ?? source.chunkId;
+var getLatestAssistantMessage = (messages) => {
+  for (let index = messages.length - 1;index >= 0; index -= 1) {
+    const message = messages[index];
+    if (message?.role === "assistant") {
+      return message;
+    }
+  }
+  return;
+};
+var getLatestRAGSources = (messages) => getLatestAssistantMessage(messages)?.sources ?? [];
+var buildRAGSourceGroups = (sources) => {
+  const groups = new Map;
+  for (const source of sources) {
+    const key = buildSourceGroupKey(source);
+    const existing = groups.get(key);
+    if (existing) {
+      existing.bestScore = Math.max(existing.bestScore, source.score);
+      existing.count += 1;
+      existing.chunks.push(source);
+      continue;
+    }
+    groups.set(key, {
+      bestScore: source.score,
+      chunks: [source],
+      count: 1,
+      key,
+      label: buildSourceLabel(source),
+      source: source.source,
+      title: source.title
+    });
+  }
+  return [...groups.values()].sort((left, right) => {
+    if (right.bestScore !== left.bestScore) {
+      return right.bestScore - left.bestScore;
+    }
+    return left.label.localeCompare(right.label);
+  });
+};
+var buildRAGCitations = (sources) => {
+  const unique = new Map;
+  for (const source of sources) {
+    const key = source.chunkId;
+    const existing = unique.get(key);
+    if (existing && existing.score >= source.score) {
+      continue;
+    }
+    unique.set(key, {
+      chunkId: source.chunkId,
+      key,
+      label: buildSourceLabel(source),
+      metadata: source.metadata,
+      score: source.score,
+      source: source.source,
+      text: source.text,
+      title: source.title
+    });
+  }
+  return [...unique.values()].sort((left, right) => {
+    if (right.score !== left.score) {
+      return right.score - left.score;
+    }
+    return left.label.localeCompare(right.label);
+  });
+};
+var resolveRAGStreamStage = ({
+  error,
+  isStreaming,
+  messages
+}) => {
+  if (error) {
+    return "error";
+  }
+  const assistantMessage = getLatestAssistantMessage(messages);
+  if (!assistantMessage) {
+    return isStreaming ? "submitting" : "idle";
+  }
+  if (!isStreaming) {
+    return "complete";
+  }
+  const hasSources = (assistantMessage.sources?.length ?? 0) > 0;
+  const hasContent = assistantMessage.content.trim().length > 0 || assistantMessage.thinking?.trim().length || (assistantMessage.toolCalls?.length ?? 0) > 0 || (assistantMessage.images?.length ?? 0) > 0;
+  if (hasSources && !hasContent) {
+    return "retrieved";
+  }
+  return "streaming";
+};
+
+// src/react/ai/useRAGCitations.ts
+var useRAGCitations = (sources) => {
+  const citations = useMemo(() => buildRAGCitations(sources), [sources]);
+  const sourceGroups = useMemo(() => buildRAGSourceGroups(sources), [sources]);
+  return {
+    citations,
+    hasCitations: citations.length > 0,
+    sourceGroups
+  };
+};
+
 // src/react/ai/useRAGIngest.ts
-import { useCallback as useCallback2, useMemo, useState } from "react";
+import { useCallback as useCallback2, useMemo as useMemo2, useState } from "react";
 
 // src/ai/client/ragClient.ts
 var jsonHeaders = {
@@ -855,11 +962,13 @@ var createRAGClient = (options) => {
 
 // src/react/ai/useRAGIngest.ts
 var useRAGIngest = (path) => {
-  const client = useMemo(() => createRAGClient({ path }), [path]);
+  const client = useMemo2(() => createRAGClient({ path }), [path]);
   const [error, setError] = useState(null);
   const [isIngesting, setIsIngesting] = useState(false);
   const [lastIngestCount, setLastIngestCount] = useState(null);
-  const ingest = useCallback2(async (chunks) => {
+  const [lastDocumentCount, setLastDocumentCount] = useState(null);
+  const [lastResponse, setLastResponse] = useState(null);
+  const ingestChunks = useCallback2(async (chunks) => {
     setIsIngesting(true);
     setError(null);
     try {
@@ -868,6 +977,8 @@ var useRAGIngest = (path) => {
         throw new Error(response.error ?? "RAG ingest failed");
       }
       setLastIngestCount(response.count ?? chunks.length);
+      setLastDocumentCount(null);
+      setLastResponse(response);
       return response;
     } catch (caught) {
       const message = caught instanceof Error ? caught.message : String(caught);
@@ -877,26 +988,79 @@ var useRAGIngest = (path) => {
       setIsIngesting(false);
     }
   }, [client]);
+  const ingestDocuments = useCallback2(async (input) => {
+    setIsIngesting(true);
+    setError(null);
+    try {
+      const response = await client.ingestDocuments(input);
+      if (!response.ok) {
+        throw new Error(response.error ?? "RAG ingest failed");
+      }
+      setLastIngestCount(response.count ?? null);
+      setLastDocumentCount(response.documentCount ?? input.documents.length);
+      setLastResponse(response);
+      return response;
+    } catch (caught) {
+      const message = caught instanceof Error ? caught.message : String(caught);
+      setError(message);
+      throw caught;
+    } finally {
+      setIsIngesting(false);
+    }
+  }, [client]);
+  const clearIndex = useCallback2(async () => {
+    setIsIngesting(true);
+    setError(null);
+    try {
+      await client.clearIndex();
+      setLastIngestCount(0);
+      setLastDocumentCount(0);
+      setLastResponse(null);
+    } catch (caught) {
+      const message = caught instanceof Error ? caught.message : String(caught);
+      setError(message);
+      throw caught;
+    } finally {
+      setIsIngesting(false);
+    }
+  }, [client]);
+  const reset = useCallback2(() => {
+    setError(null);
+    setLastDocumentCount(null);
+    setLastIngestCount(null);
+    setLastResponse(null);
+  }, []);
   return {
+    clearIndex,
     error,
-    ingest,
+    ingest: ingestChunks,
+    ingestChunks,
+    ingestDocuments,
     isIngesting,
-    lastIngestCount
+    lastDocumentCount,
+    lastIngestCount,
+    lastResponse,
+    reset
   };
 };
+
 // src/react/ai/useRAGSearch.ts
-import { useCallback as useCallback3, useMemo as useMemo2, useState as useState2 } from "react";
+import { useCallback as useCallback3, useMemo as useMemo3, useState as useState2 } from "react";
 var useRAGSearch = (path) => {
-  const client = useMemo2(() => createRAGClient({ path }), [path]);
+  const client = useMemo3(() => createRAGClient({ path }), [path]);
   const [results, setResults] = useState2([]);
   const [error, setError] = useState2(null);
   const [isSearching, setIsSearching] = useState2(false);
+  const [hasSearched, setHasSearched] = useState2(false);
+  const [lastRequest, setLastRequest] = useState2(null);
   const search = useCallback3(async (input) => {
     setIsSearching(true);
     setError(null);
+    setLastRequest(input);
     try {
       const nextResults = await client.search(input);
       setResults(nextResults);
+      setHasSearched(true);
       return nextResults;
     } catch (caught) {
       const message = caught instanceof Error ? caught.message : String(caught);
@@ -906,18 +1070,42 @@ var useRAGSearch = (path) => {
       setIsSearching(false);
     }
   }, [client]);
+  const reset = useCallback3(() => {
+    setError(null);
+    setHasSearched(false);
+    setLastRequest(null);
+    setResults([]);
+  }, []);
   return {
     error,
+    hasSearched,
     isSearching,
+    lastRequest,
+    reset,
     results,
     search,
     setResults
   };
 };
+
+// src/react/ai/useRAGSources.ts
+import { useMemo as useMemo4 } from "react";
+var useRAGSources = (messages) => {
+  const latestAssistantMessage = useMemo4(() => getLatestAssistantMessage(messages), [messages]);
+  const sources = useMemo4(() => getLatestRAGSources(messages), [messages]);
+  const sourceGroups = useMemo4(() => buildRAGSourceGroups(sources), [sources]);
+  return {
+    hasSources: sources.length > 0,
+    latestAssistantMessage,
+    sourceGroups,
+    sources
+  };
+};
+
 // src/react/ai/useRAGStatus.ts
-import { useCallback as useCallback4, useEffect as useEffect3, useMemo as useMemo3, useState as useState3 } from "react";
+import { useCallback as useCallback4, useEffect as useEffect3, useMemo as useMemo5, useState as useState3 } from "react";
 var useRAGStatus = (path, autoLoad = true) => {
-  const client = useMemo3(() => createRAGClient({ path }), [path]);
+  const client = useMemo5(() => createRAGClient({ path }), [path]);
   const [status, setStatus] = useState3();
   const [capabilities, setCapabilities] = useState3();
   const [error, setError] = useState3(null);
@@ -938,6 +1126,12 @@ var useRAGStatus = (path, autoLoad = true) => {
       setIsLoading(false);
     }
   }, [client]);
+  const reset = useCallback4(() => {
+    setCapabilities(undefined);
+    setError(null);
+    setIsLoading(false);
+    setStatus(undefined);
+  }, []);
   useEffect3(() => {
     if (!autoLoad) {
       setIsLoading(false);
@@ -950,19 +1144,67 @@ var useRAGStatus = (path, autoLoad = true) => {
     error,
     isLoading,
     refresh,
+    reset,
     status
   };
 };
+
 // src/react/ai/useRAGStream.ts
-var useRAGStream = useAIStream;
+import { useCallback as useCallback5, useMemo as useMemo6 } from "react";
+var useRAGStream = (path, conversationId) => {
+  const stream = useAIStream(path, conversationId);
+  const latestAssistantMessage = useMemo6(() => getLatestAssistantMessage(stream.messages), [stream.messages]);
+  const sources = useMemo6(() => getLatestRAGSources(stream.messages), [stream.messages]);
+  const sourceGroups = useMemo6(() => buildRAGSourceGroups(sources), [sources]);
+  const citations = useMemo6(() => buildRAGCitations(sources), [sources]);
+  const stage = useMemo6(() => resolveRAGStreamStage({
+    error: stream.error,
+    isStreaming: stream.isStreaming,
+    messages: stream.messages
+  }), [stream.error, stream.isStreaming, stream.messages]);
+  const query = useCallback5((content, attachments) => {
+    stream.send(content, attachments);
+  }, [stream]);
+  return {
+    ...stream,
+    citations,
+    hasSources: sources.length > 0,
+    latestAssistantMessage,
+    query,
+    sourceGroups,
+    sources,
+    stage
+  };
+};
+
+// src/react/ai/useRAG.ts
+var useRAG = (path, options = {}) => {
+  const search = useRAGSearch(path);
+  const ingest = useRAGIngest(path);
+  const status = useRAGStatus(path, options.autoLoadStatus ?? true);
+  const stream = useRAGStream(options.streamPath ?? path, options.conversationId);
+  const sources = useRAGSources(stream.messages);
+  const citations = useRAGCitations(sources.sources);
+  return useMemo7(() => ({
+    citations,
+    ingest,
+    search,
+    sources,
+    status,
+    stream
+  }), [citations, ingest, search, sources, status, stream]);
+};
 export {
   useRAGStream,
   useRAGStatus,
+  useRAGSources,
   useRAGSearch,
   useRAGIngest,
+  useRAGCitations,
+  useRAG,
   useAIStream,
   AIStreamProvider
 };
 
-//# debugId=5314A0A8B1FD91F264756E2164756E21
+//# debugId=D0ADC407D5CCE73D64756E2164756E21
 //# sourceMappingURL=index.js.map