import "./Example.css"; import { useConvex } from "convex/react"; import { usePaginatedQuery } from "convex-helpers/react"; import { api } from "../convex/_generated/api"; import { useCallback, useState, useEffect } from "react"; import type { EntryFilter, SearchResult, SearchType } from "@convex-dev/rag"; import type { Filters, PublicFile } from "../convex/example"; import { MarkdownRenderer } from "./MarkdownRenderer"; import { UploadSection } from "./components/UploadSection"; import { FileList } from "./components/FileList"; import { SearchInterface } from "./components/SearchInterface"; type SearchScope = "general" | "category" | "file"; type QueryMode = "search" | "question"; interface UISearchResult { results: (SearchResult & { entry: PublicFile; })[]; text: string; files: Array; } interface UIQuestionResult { answer: string; results: (SearchResult & { entry: PublicFile; })[]; files: Array; } function Example() { const [searchScope, setSearchScope] = useState("general"); const [searchGlobal, setSearchGlobal] = useState(true); const [searchQuery, setSearchQuery] = useState(""); const [selectedDocument, setSelectedDocument] = useState( null, ); const [selectedCategory, setSelectedCategory] = useState(""); const [searchResults, setSearchResults] = useState( null, ); const [questionResult, setQuestionResult] = useState( null, ); const [isSearching, setIsSearching] = useState(false); const [categorySearchGlobal, setCategorySearchGlobal] = useState(true); const [showFullText, setShowFullText] = useState(false); // New state for search parameters const [limit, setLimit] = useState(10); const [chunksBefore, setChunksBefore] = useState(1); const [chunksAfter, setChunksAfter] = useState(1); const [categories, setCategories] = useState([]); const [searchType, setSearchType] = useState("vector"); // Convex functions const convex = useConvex(); const documentChunks = usePaginatedQuery( api.example.listChunks, selectedDocument?.entryId ? { entryId: selectedDocument.entryId, order: "asc", } : "skip", { initialNumItems: 10 }, ); const handleSearch = useCallback( async (mode: QueryMode) => { if (!searchQuery.trim()) return; if (searchScope === "file" && !selectedDocument) { alert("Please select a file to search"); return; } if (searchScope === "category" && !selectedCategory.trim()) { alert("Please select a category for category search"); return; } setIsSearching(true); setSearchResults(null); setQuestionResult(null); try { const chunkContext = { before: chunksBefore, after: chunksAfter }; if (mode === "question") { let filter: EntryFilter | undefined; if (searchScope === "category") { filter = { name: "category" as const, value: selectedCategory, }; } else if (searchScope === "file" && selectedDocument) { filter = { name: "filename" as const, value: selectedDocument.filename, }; } const globalNamespace = searchScope === "general" ? searchGlobal : searchScope === "category" ? categorySearchGlobal : searchScope === "file" && selectedDocument ? selectedDocument.global : searchGlobal; const questionResults = await convex.action(api.example.askQuestion, { prompt: searchQuery, globalNamespace: globalNamespace || false, filter, limit, chunkContext, searchType, }); const questionSources = questionResults?.files || []; const formattedSearchResults = { ...questionResults, results: questionResults.results.map((result) => ({ ...result, entry: questionSources.find((s) => s.entryId === result.entryId)!, })), }; // Set search results setSearchResults(formattedSearchResults); setQuestionResult({ answer: questionResults.answer, results: questionResults.results.map((result) => ({ ...result, entry: questionSources.find((s) => s.entryId === result.entryId)!, })), files: questionSources, }); } else { // Handle search mode (existing logic) let results; switch (searchScope) { case "general": results = await convex.action(api.example.search, { query: searchQuery, globalNamespace: searchGlobal, limit, chunkContext, searchType, }); break; case "category": results = await convex.action(api.example.searchCategory, { query: searchQuery, globalNamespace: categorySearchGlobal, category: selectedCategory, limit, chunkContext, searchType, }); break; case "file": results = await convex.action(api.example.searchFile, { query: searchQuery, globalNamespace: selectedDocument!.global || false, filename: selectedDocument!.filename || "", limit, chunkContext, searchType, }); break; default: throw new Error(`Unknown search scope: ${searchScope}`); } const sources = results?.files || []; setSearchResults({ ...results, results: results.results.map((result: any) => ({ ...result, entry: sources.find((s: any) => s.entryId === result.entryId)!, })), }); } } catch (error) { console.error("Search/Question failed:", error); alert( `${mode === "question" ? "Question" : "Search"} failed. ${error instanceof Error ? error.message : String(error)}`, ); } finally { setIsSearching(false); } }, [ searchQuery, searchScope, searchGlobal, selectedDocument, selectedCategory, convex, categorySearchGlobal, limit, chunksBefore, chunksAfter, searchType, ], ); const handleFileSelect = (file: PublicFile | null) => { setSelectedDocument(file); if (file) { setSearchScope("file"); } }; const handleCategorySelect = (category: string) => { setSelectedCategory(category); setSearchScope("category"); }; const handleSearchTypeChange = (type: SearchScope, global: boolean) => { setSearchScope(type); setSearchGlobal(global); setSelectedDocument(null); }; useEffect(() => { setSearchResults(null); setQuestionResult(null); }, [searchScope]); return (
{/* Left Panel - Document List */}
{/* Main Content Area */}
{/* Results Area */}
{/* Question Results */} {questionResult && (
{/* Generated Answer */}
🤖

Generated Answer

{questionResult.answer}
)} {/* Document Chunks for File queries */} {searchScope === "file" && selectedDocument && documentChunks.status !== "LoadingFirstPage" && !searchResults && (

Document Chunks ({documentChunks.results.length || 0})

{selectedDocument.url && (
{selectedDocument.isImage ? (
{selectedDocument.filename}
) : ( {selectedDocument.filename} )}
)}
{documentChunks.results.map((chunk) => (
{chunk.order}
{chunk.text}
))} {documentChunks.status === "CanLoadMore" && (
)}
)} {/* Search Results */} {searchResults && (
{/* Sources Section */}

Sources

{searchResults.files && searchResults.files.length > 0 && (
{searchResults.files.map((doc, index) => (
{doc.url ? ( {doc.title || doc.url} ) : ( {doc.title || doc.filename} )}
))}
)}
{/* Results Section */}

Search Results ({searchResults.results.length})

Individual Results Combined Context
{showFullText && searchResults.text ? (

Complete Search Text

{searchResults.text}
) : (
{searchResults.results.map((result, index) => (
{index + 1}
{result.entry.title || result.entry.filename}
Score:
{result.score.toFixed(3)}
{result.content.map((content, contentIndex) => { const isHighlighted = contentIndex + result.startOrder === result.order; return (
{content.text}
); })}
))}
)}
)} {/* Empty State */} {!searchResults && !questionResult && (
{isSearching ? (

Searching...

Please wait while we search your documents

) : ( <>

Ready to Search or Ask

Use the 🔍 button to search your documents or the Ask button to get AI-generated answers using search context.

)}
)}
); } export default Example;