Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

16.9 KB
Raw Blame
"use client";

import { knowledgeBaseRef } from "@/lib/knowledge-helpers";
import { moveKnowledgeBase, resourceUsage } from "@/lib/workspaces-api";
import { apiFetch, apiUrl } from "@/lib/api";
import type { EmbeddingModelSelection } from "@/features/knowledge/model/types";

import dynamic from "next/dynamic";
import { useCallback, useEffect, useMemo, useState } from "react";
import { useParams, useRouter, useSearchParams } from "next/navigation";
import { useTranslation } from "react-i18next";
import { Loader2 } from "lucide-react";
import { useKnowledgeBases } from "@/hooks/useKnowledgeBases";
import { updateRagProviderMode } from "@/features/knowledge/api/engines";
import KnowledgeHome, { type KnowledgeHomeSection } from "./KnowledgeHome";
import {
  decodeResourceSegment,
  knowledgeBaseRoute,
} from "@/lib/resource-routes";
import type {
  IndexingLLMSelection,
  LinkedFolderInfo,
  SyncFolderResponse,
} from "@/features/knowledge/model/types";

const panelLoading = () => (
  <div
    className="flex min-h-0 flex-1 items-center justify-center"
    aria-busy="true"
  >
    <Loader2 className="h-5 w-5 animate-spin text-[var(--muted-foreground)]" />
  </div>
);

// These panels are not part of the Knowledge overview's first interaction.
// Keep their large forms and engine controls out of the overview bundle, while
// still server-rendering the relevant panel for direct detail links.
const KnowledgeBaseDetail = dynamic(() => import("./KnowledgeBaseDetail"), {
  loading: panelLoading,
});
const EngineDetail = dynamic(
  () => import("@/features/knowledge/components/engines/EngineDetail"),
  {
    loading: panelLoading,
  },
);
const CreateKbModal = dynamic(() => import("./CreateKbModal"));
const ConnectKiwixModal = dynamic(() => import("./ConnectKiwixModal"));

export default function KnowledgePage() {
  const { t } = useTranslation();
  const router = useRouter();
  const routeParams = useParams<{ kbName?: string }>();
  const searchParams = useSearchParams();
  const initialKb = decodeResourceSegment(routeParams.kbName);
  const initialEngine = searchParams.get("engine");
  const initialHomeSection: KnowledgeHomeSection =
    initialEngine || searchParams.get("section") === "engines"
      ? "knowledge-engines"
      : "knowledge-bases";

  const {
    kbs: allKbs,
    providers,
    uploadPolicy,
    loading,
    error,
    setError,
    tasksByKb,
    historyByKb,
    clearHistory,
    refresh,
    createKb,
    uploadFiles,
    setDefault,
    reindex,
    retry,
    deleteKb,
    connectObsidian,
    connectLinkedFolder,
    linkFolder,
    unlinkFolder,
    syncLinkedFolder,
    connectLightRagServer,
    connectWeKnora,
    connectMarginNote4,
    connectIma,
    connectKiwix,
  } = useKnowledgeBases();

  // Connected subagents are stored as ``type: subagent`` KBs so the chat
  // composer can select them, but they are agents, not knowledge bases — keep
  // them out of the Knowledge Center entirely.
  const kbs = useMemo(
    () => allKbs.filter((kb) => kb.metadata?.type !== "subagent"),
    [allKbs],
  );

  const [explicitSelection, setExplicitSelection] = useState<string | null>(
    initialKb,
  );
  const [selectedEngineId, setSelectedEngineId] = useState<string | null>(
    initialEngine,
  );
  const [homeSection, setHomeSection] =
    useState<KnowledgeHomeSection>(initialHomeSection);
  const [createOpen, setCreateOpen] = useState(false);
  const [kiwixOpen, setKiwixOpen] = useState(false);
  const [createPreset, setCreatePreset] = useState<{
    mode: "new" | "link";
    source?: string;
  } | null>(null);

  const openCreate = useCallback(() => {
    setCreatePreset(null);
    setCreateOpen(true);
  }, []);
  const openSource = useCallback((source: "obsidian" | "marginnote4" | "kiwix") => {
    if (source === "kiwix") {
      setKiwixOpen(true);
      return;
    }
    setCreatePreset({ mode: "link", source });
    setCreateOpen(true);
  }, []);
  // Lands on the Overview console unless deep-linked to a KB or an engine.
  const [view, setView] = useState<"home" | "kb" | "engine">(
    initialEngine ? "engine" : initialKb ? "kb" : "home",
  );

  // Dynamic segment changes do not necessarily remount this client page.
  // Follow the route on browser history navigation instead of restoring a
  // stale in-memory selection over it.
  useEffect(() => {
    if (initialKb) {
      setExplicitSelection(initialKb);
      setView("kb");
    } else if (view === "kb") {
      setExplicitSelection(null);
      setView("home");
    }
    // Only a route transition should drive this synchronization.
    // eslint-disable-next-line react-hooks/exhaustive-deps
  }, [initialKb]);

  const openKb = useCallback((name: string) => {
    setHomeSection("knowledge-bases");
    setExplicitSelection(name);
    setView("kb");
  }, []);

  const openEngine = useCallback((id: string) => {
    setHomeSection("knowledge-engines");
    setSelectedEngineId(id);
    setView("engine");
  }, []);

  // Derive the effective selection: respect the user's pick if it still
  // exists, otherwise fall back to the default KB (or the first one). No
  // useEffect chains — keeps state out of effects.
  const selectedKbName = useMemo<string | null>(() => {
    // Do not erase a direct `/knowledge-bases/<name>` visit while the catalog
    // request is still in flight. Once loading finishes, the normal existence
    // check below may repair an actually stale name to the default KB.
    if (loading && explicitSelection) return explicitSelection;
    const exact = kbs.find((kb) => knowledgeBaseRef(kb) === explicitSelection);
    if (exact) return knowledgeBaseRef(exact);
    const legacy = kbs.filter((kb) => kb.name === explicitSelection);
    if (legacy.length === 1) return knowledgeBaseRef(legacy[0]);
    if (explicitSelection) return explicitSelection;
    if (!kbs.length) return null;
    return knowledgeBaseRef(kbs.find((kb) => kb.is_default) ?? kbs[0]);
  }, [explicitSelection, kbs, loading]);

  const selectedKb = useMemo(
    () => kbs.find((kb) => knowledgeBaseRef(kb) === selectedKbName) ?? null,
    [kbs, selectedKbName],
  );

  // Saved links may still contain the original qualified ID after a move.
  // The detail endpoint resolves that ID through the server's move alias.
  useEffect(() => {
    if (
      loading ||
      !explicitSelection ||
      kbs.some((kb) => knowledgeBaseRef(kb) === explicitSelection || kb.name === explicitSelection)
    ) return;
    let cancelled = false;
    void apiFetch(
      apiUrl(`/api/knowledge-bases/${encodeURIComponent(explicitSelection)}?resource_library=true`),
    )
      .then((response) => response.ok ? response.json() : null)
      .then((detail: { id?: string } | null) => {
        if (!cancelled && detail?.id && kbs.some((kb) => knowledgeBaseRef(kb) === detail.id)) {
          setExplicitSelection(detail.id);
        }
      })
      .catch(() => undefined);
    return () => { cancelled = true; };
  }, [explicitSelection, kbs, loading]);

  // The effective engine selection: respect the pick if it still exists.
  const selectedProvider = useMemo(
    () => providers.find((p) => p.id === selectedEngineId) ?? null,
    [providers, selectedEngineId],
  );

  // Keep the KB identity in the path. Engine selection and overview section
  // remain query state because they are views/filters, not KB resources.
  const urlKb = view === "kb" ? (selectedKbName ?? null) : null;
  const urlEngine = view === "engine" ? (selectedProvider?.id ?? null) : null;
  const urlSection =
    view === "home" && homeSection === "knowledge-engines" ? "engines" : null;
  useEffect(() => {
    if (typeof window === "undefined") return;
    if (
      initialKb === urlKb &&
      searchParams.get("engine") === urlEngine &&
      searchParams.get("section") === urlSection
    ) {
      return;
    }
    const params = new URLSearchParams(Array.from(searchParams.entries()));
    params.delete("kb");
    if (urlEngine) params.set("engine", urlEngine);
    else params.delete("engine");
    if (urlSection) params.set("section", urlSection);
    else params.delete("section");
    const search = params.toString();
    const pathname = knowledgeBaseRoute(urlKb);
    router.replace(search ? `${pathname}?${search}` : pathname, {
      scroll: false,
    });
  }, [initialKb, router, searchParams, urlKb, urlEngine, urlSection]);

  const handleCreate = useCallback(
    async (params: {
      name: string;
      provider: string;
      files: File[];
      storageWorkspaceId?: string;
      pageindexMode?: "flash" | "standard";
      searchMode?: string;
    }) => {
      try {
        const result = await createKb(params);
        openKb(result.id || `account:kb:${params.name}`);
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err));
        throw err;
      }
    },
    [createKb, openKb, setError],
  );

  const handleMove = useCallback(
    async (sourceId: string, targetWorkspaceId: string) => {
      try {
        const result = await moveKnowledgeBase(sourceId, targetWorkspaceId);
        await refresh({ force: true });
        openKb(result.target_id);
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err));
        throw err;
      }
    },
    [openKb, refresh, setError],
  );

  const handleSetDefault = useCallback(
    async (name: string) => {
      try {
        await setDefault(name);
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err));
      }
    },
    [setDefault, setError],
  );

  const handleDelete = useCallback(
    async (name: string) => {
      try {
        const workspaces = await resourceUsage("knowledge_bases", name);
        const impact = workspaces.length
          ? "\n\n" +
            t("Used by workspaces: {{names}}", { names: workspaces.join(", ") })
          : "";
        if (
          !window.confirm(
            t('Delete knowledge base "{{name}}"?', { name }) + impact,
          )
        )
          return;
        await deleteKb(name);
        if (explicitSelection === name) {
          setExplicitSelection(null);
          setView("home");
        }
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err));
      }
    },
    [deleteKb, explicitSelection, setError, t],
  );

  const handleUpload = useCallback(
    async (kbName: string, files: File[], destSubdir?: string) => {
      try {
        await uploadFiles(kbName, files, undefined, destSubdir);
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err));
        throw err;
      }
    },
    [setError, uploadFiles],
  );

  const handleLinkFolder = useCallback(
    async (kbName: string, folderPath: string): Promise<LinkedFolderInfo> => {
      try {
        return await linkFolder(kbName, folderPath);
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err));
        throw err;
      }
    },
    [linkFolder, setError],
  );

  const handleUnlinkFolder = useCallback(
    async (kbName: string, folderId: string): Promise<void> => {
      try {
        await unlinkFolder(kbName, folderId);
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err));
        throw err;
      }
    },
    [setError, unlinkFolder],
  );

  const handleSyncFolder = useCallback(
    async (kbName: string, folderId: string): Promise<SyncFolderResponse> => {
      try {
        return await syncLinkedFolder(kbName, folderId);
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err));
        throw err;
      }
    },
    [setError, syncLinkedFolder],
  );

  const handleReindex = useCallback(
    async (
      kbName: string,
      configFingerprint?: string,
      embeddingModel?: EmbeddingModelSelection,
    ) => {
      try {
        await reindex(kbName, configFingerprint, embeddingModel);
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err));
        throw err;
      }
    },
    [reindex, setError],
  );

  const handleRetry = useCallback(
    async (kbName: string) => {
      try {
        await retry(kbName);
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err));
      }
    },
    [retry, setError],
  );

  const handleSelectMode = useCallback(
    async (id: string, mode: string) => {
      try {
        await updateRagProviderMode(id, mode);
        await refresh();
      } catch (err) {
        setError(err instanceof Error ? err.message : String(err));
      }
    },
    [refresh, setError],
  );

  return (
    <div className="flex h-full flex-col bg-[var(--background)]">
      {error && (
        <div className="flex items-center justify-between gap-3 border-b border-red-200 bg-red-50 px-4 py-2 text-[12.5px] text-red-700 dark:border-red-900 dark:bg-red-950/30 dark:text-red-300">
          <span className="truncate">{error}</span>
          <div className="flex items-center gap-2">
            <button
              type="button"
              onClick={() => void refresh({ force: true })}
              className="rounded-md border border-red-300 px-2 py-0.5 text-[11.5px] font-medium hover:bg-red-100 dark:border-red-900 dark:hover:bg-red-950/50"
            >
              {t("Retry")}
            </button>
            <button
              type="button"
              onClick={() => setError(null)}
              className="rounded-md px-2 py-0.5 text-[11.5px] font-medium hover:bg-red-100 dark:hover:bg-red-950/50"
            >
              {t("Dismiss")}
            </button>
          </div>
        </div>
      )}

      {loading ? (
        <div className="flex flex-1 items-center justify-center">
          <Loader2 className="h-5 w-5 animate-spin text-[var(--muted-foreground)]" />
        </div>
      ) : (
        <div className="flex min-h-0 flex-1">
          {view === "home" ? (
            <KnowledgeHome
              kbs={kbs}
              providers={providers}
              onOpenKb={openKb}
              onOpenEngine={openEngine}
              onOpenSource={openSource}
              onCreate={openCreate}
              activeSection={homeSection}
              onSectionChange={setHomeSection}
            />
          ) : view === "engine" && selectedProvider ? (
            <EngineDetail
              provider={selectedProvider}
              kbs={kbs}
              onBack={() => {
                setHomeSection("knowledge-engines");
                setView("home");
              }}
              onOpenKb={openKb}
              onSelectMode={handleSelectMode}
              onChanged={() => void refresh({ force: true })}
              onError={(message) => setError(message)}
            />
          ) : view === "engine" ? (
            // Selected engine vanished (e.g. provider list changed); bounce home.
            <KnowledgeHome
              kbs={kbs}
              providers={providers}
              onOpenKb={openKb}
              onOpenEngine={openEngine}
              onOpenSource={openSource}
              onCreate={openCreate}
              activeSection={homeSection}
              onSectionChange={setHomeSection}
            />
          ) : (
            <KnowledgeBaseDetail
              kb={selectedKb}
              uploadPolicy={uploadPolicy}
              task={
                selectedKb ? tasksByKb[knowledgeBaseRef(selectedKb)] : undefined
              }
              history={
                selectedKb
                  ? (historyByKb[knowledgeBaseRef(selectedKb)] ?? [])
                  : []
              }
              onCreate={openCreate}
              onUpload={handleUpload}
              onLinkFolder={handleLinkFolder}
              onUnlinkFolder={handleUnlinkFolder}
              onSyncFolder={handleSyncFolder}
              onReindex={handleReindex}
              onRetry={handleRetry}
              onSetDefault={handleSetDefault}
              onDelete={handleDelete}
              onMove={handleMove}
              onClearHistory={clearHistory}
              onBack={() => {
                setHomeSection("knowledge-bases");
                setView("home");
              }}
            />
          )}
        </div>
      )}

      {createOpen ? (
        <CreateKbModal
          isOpen
          onClose={() => setCreateOpen(false)}
          providers={providers}
          uploadPolicy={uploadPolicy}
          onCreate={handleCreate}
          onConnectLinkedFolder={connectLinkedFolder}
          onConnectObsidian={connectObsidian}
          onConnectLightRagServer={connectLightRagServer}
          onConnectWeKnora={connectWeKnora}
          onConnectMarginNote4={connectMarginNote4}
          onConnectIma={connectIma}
          initialMode={createPreset?.mode}
          initialSource={createPreset?.source}
          onConfigureProvider={(providerId) => {
            setCreateOpen(false);
            openEngine(providerId);
          }}
        />
      ) : null}
      {kiwixOpen ? (
        <ConnectKiwixModal
          onClose={() => setKiwixOpen(false)}
          onConnect={async (params) => {
            await connectKiwix(params);
            openKb(`account:kb:${params.name}`);
          }}
        />
      ) : null}
    </div>
  );
}