"use client"; import { useState } from "react"; import Link from "next/link"; import { BookMarked, ChevronDown } from "lucide-react"; import { Collapsible, CollapsibleContent, CollapsibleTrigger, } from "@/components/ui/collapsible"; import { useI18n } from "@/i18n/i18n-context"; import { cn } from "@/lib/utils"; import type { WikiEvidence, WikiRetrievalError, WikiRetrievalGroup, } from "@/types/llm-chat"; export interface WikiEvidenceScope { appId: string; tenantId: string; agentId: string; runId: string; } interface WikiEvidenceBlockProps { query?: string; pages: WikiEvidence[]; groups: WikiRetrievalGroup[]; memoryStoreName?: string; scope?: WikiEvidenceScope; totalContextChars?: number; } export function wikiEvidenceHref( memoryStoreName: string, scope: WikiEvidenceScope, page: Pick, ): string { const query = new URLSearchParams([ ["appId", scope.appId], ["tenantId", scope.tenantId], ["agentId", scope.agentId], ["runId", scope.runId], ]); query.set("path", page.path); return `/memory/${encodeURIComponent(memoryStoreName)}/wiki?${query.toString()}`; } function hasNavigationTarget( memoryStoreName: string | undefined, scope: WikiEvidenceScope | undefined, ): scope is WikiEvidenceScope { return Boolean( memoryStoreName && scope && scope.appId && scope.tenantId && scope.agentId && scope.runId, ); } function fallbackGroups(pages: WikiEvidence[]): WikiRetrievalGroup[] { const byWiki = new Map(); for (const page of pages) { const current = byWiki.get(page.wikiName); if (current) { current.pages.push(page); continue; } byWiki.set(page.wikiName, { wikiName: page.wikiName, pages: [page], }); } return [...byWiki.values()]; } export function resolveWikiEvidenceGroups( pages: WikiEvidence[], groups: WikiRetrievalGroup[], ): WikiRetrievalGroup[] { return (groups.length > 0 ? groups : fallbackGroups(pages)).filter( (group) => group.pages.length > 0 || (group.errors?.length ?? 0) > 0, ); } export function wikiEvidencePageCount(groups: WikiRetrievalGroup[]): number { return groups.reduce((count, group) => count + group.pages.length, 0); } export function WikiEvidenceBlock({ query, pages, groups, memoryStoreName, scope, totalContextChars, }: WikiEvidenceBlockProps) { const { t } = useI18n(); const [open, setOpen] = useState(false); // A successful search hit that contributed no injected evidence is not UI // evidence. Keep only authoritative group pages and explicit failures. const renderedGroups = resolveWikiEvidenceGroups(pages, groups); const pageCount = wikiEvidencePageCount(renderedGroups); const title = t("qa.message.wikiReferences", { count: pageCount }); const triggerLabel = `${title} · ${ open ? t("qa.chunks.collapse") : t("qa.chunks.expand") }`; return (
); } export function WikiEvidenceContent({ groups, memoryStoreName, scope, }: { groups: WikiRetrievalGroup[]; memoryStoreName?: string; scope?: WikiEvidenceScope; }) { return (
{groups.map((group, groupIndex) => ( ))}
); } function WikiEvidenceGroup({ group, memoryStoreName, scope, }: { group: WikiRetrievalGroup; memoryStoreName?: string; scope?: WikiEvidenceScope; }) { return (
{group.wikiName}
{(group.errors ?? []).map((error, index) => ( ))} {group.pages.map((page) => ( ))}
); } function WikiEvidenceError({ error, wikiName, }: { error: WikiRetrievalError; wikiName: string; }) { const { t } = useI18n(); return (
{t("qa.message.wikiUnavailable", { name: wikiName })}
{t("qa.message.wikiErrorCode", { code: error.code })}
{t("qa.message.wikiErrorMessage", { message: error.message })}
{error.requestId ? (
{t("qa.message.wikiRequestId", { requestId: error.requestId })}
) : null} {error.httpStatus !== undefined ? (
{t("qa.message.wikiHttpStatus", { httpStatus: error.httpStatus, })}
) : null}
{t("qa.message.wikiErrorStage", { stage: error.stage })}
{error.path ? (
{t("qa.message.wikiErrorPath", { path: error.path })}
) : null}
); } function WikiEvidenceCard({ page, memoryStoreName, scope, }: { page: WikiEvidence; memoryStoreName?: string; scope?: WikiEvidenceScope; }) { const { t } = useI18n(); const canNavigate = hasNavigationTarget(memoryStoreName, scope); const pathMetadata = canNavigate ? ( {page.path} ) : ( {page.path} ); return (
[{page.reference}] {pathMetadata} {page.title ? ( {page.title} ) : null} {page.type ? ( {page.type} ) : null}
{page.description ? (

{page.description}

) : null}
{page.score !== undefined ? ( {t("qa.message.wikiScore", { score: String(page.score) })} ) : null} {t("qa.message.wikiInjectedChars", { count: page.injectedChars, })} {page.truncated ? ( {t("qa.message.wikiTruncated")} ) : null}
{page.sources && page.sources.length > 0 ? (
{t("qa.message.wikiSources", { sources: page.sources.join(", "), })}
) : null}
); }