Skip to content

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

58.5 KB
Raw Blame
"use client";

import Tooltip from "@/shared/ui/Tooltip";
import type { EmbeddingModelSelection } from "@/features/knowledge/model/types";

import { useEffect, useRef, useState, type ReactNode } from "react";
import { useTranslation } from "react-i18next";
import {
  AlertTriangle,
  Check,
  ChevronRight,
  Database,
  ExternalLink,
  FolderSearch,
  Link2,
  Loader2,
  Plus,
  Server,
} from "lucide-react";
import { useEmbeddingModels } from "@/hooks/useEmbeddingModels";
import EmbeddingModelSelector from "./EmbeddingModelSelector";
import Modal from "@/components/common/Modal";
import { useImaConnection } from "@/hooks/useImaConnection";
import { useLLMOptions } from "@/hooks/useLLMOptions";
import {
  getGraphRagConfig,
  getLightRagConfig,
  getLightRagModelOptions,
  getLightRagServerConfig,
  getLlamaIndexConfig,
  getPageIndexConfig,
  probeLightRagServer,
  type LightRagServerProbe,
} from "@/features/knowledge/api/engines";
import {
  probeLinkedFolder,
  probeWeKnora,
  type KnowledgeUploadPolicy,
  type LinkedFolderProbe,
  type RagProviderSummary,
  type WeKnoraProbe,
} from "@/features/knowledge/api/catalog";
import {
  createProviders,
  IMA_PROVIDER,
  linkSourceEnabled,
} from "@/lib/ima-connection";
import {
  uploadPolicyForProvider,
  validateFiles,
} from "@/lib/knowledge-helpers";
import { forbiddenKbNameChars, isValidKbName } from "@/lib/kb-name";
import { activeWorkspaceId } from "@/lib/workspace-scope";
import FileDropZone from "./FileDropZone";
import ImaConnectionFields from "./ImaConnectionFields";
import KnowledgeEngineIcon from "./KnowledgeEngineIcon";
import {
  indexingSelectionFromDefaults,
  isCompleteIndexingSelection,
} from "./LightRagIndexingSelector";
import { resolvedRole } from "./LightRagRoleModelsEditor";

const OBSIDIAN_SOURCE = "obsidian";
const MARGINNOTE4_SOURCE = "marginnote4";
const LIGHTRAG_SERVER_PROVIDER = "lightrag-server";
const WEKNORA_PROVIDER = "weknora";
const EXAMPLE_INDEX_PATH = "/Users/you/knowledge_bases/my-kb";
const EXAMPLE_VAULT_PATH = "/Users/you/Documents/MyVault";
const EXAMPLE_SERVER_URL = "http://localhost:9621";

type Mode = "new" | "link";

interface CreateKbModalProps {
  isOpen: boolean;
  onClose: () => void;
  providers: RagProviderSummary[];
  uploadPolicy: KnowledgeUploadPolicy;
  onCreate: (params: {
    name: string;
    provider: string;
    files: File[];
    storageWorkspaceId?: string;
    pageindexMode?: "flash" | "standard";
    searchMode?: string;
    embeddingModel?: EmbeddingModelSelection;
  }) => Promise<void>;
  /** Link a pre-built engine index folder in place (no copy, no re-index). */
  onConnectLinkedFolder: (params: {
    name: string;
    folderPath: string;
    provider: string;
  }) => Promise<void>;
  /** Connect a live Obsidian vault (no index). */
  onConnectObsidian: (params: {
    name: string;
    vaultPath: string;
  }) => Promise<void>;
  /** Connect an external LightRAG server (retrieval only, no local index). */
  onConnectLightRagServer: (params: {
    name: string;
    serverUrl: string;
    apiKey?: string;
    mode?: string;
  }) => Promise<void>;
  /** Connect a self-hosted WeKnora knowledge base (retrieval only). */
  onConnectWeKnora: (params: {
    name: string;
    serverUrl: string;
    apiKey: string;
    knowledgeBaseId: string;
  }) => Promise<void>;
  /** Connect a MarginNote 4 library (its Add-on pushes objects in; no index). */
  onConnectMarginNote4: (params: { name: string }) => Promise<void>;
  /** Connect a Tencent IMA knowledge base (retrieval only, no local index). */
  onConnectIma: (params: {
    name: string;
    clientId: string;
    apiKey: string;
    knowledgeBaseId: string;
  }) => Promise<void>;
  /** Open the RAG pipeline settings (to add a missing API key). */
  onConfigureProvider?: (providerId: string) => void;
  /** Open straight into a given mode (e.g. "link" from the Obsidian card). */
  initialMode?: Mode;
  /** Pre-select a link source (engine id or "obsidian") when opening in link mode. */
  initialSource?: string;
}

export default function CreateKbModal({
  isOpen,
  onClose,
  providers,
  uploadPolicy,
  onCreate,
  onConnectLinkedFolder,
  onConnectObsidian,
  onConnectLightRagServer,
  onConnectWeKnora,
  onConnectMarginNote4,
  onConnectIma,
  onConfigureProvider,
  initialMode = "new",
  initialSource,
}: CreateKbModalProps) {
  const { t } = useTranslation();
  const [mode, setMode] = useState<Mode>("new");
  const [name, setName] = useState("");
  const [provider, setProvider] = useState("llamaindex");
  const [files, setFiles] = useState<File[]>([]);
  const [pageIndexMode, setPageIndexMode] = useState<"" | "flash" | "standard">(
    "",
  );
  // Link mode: the source is either an engine id or the Obsidian sentinel.
  const [linkSource, setLinkSource] = useState(OBSIDIAN_SOURCE);
  const [folderPath, setFolderPath] = useState("");
  const [probe, setProbe] = useState<LinkedFolderProbe | null>(null);
  const [probing, setProbing] = useState(false);
  // LightRAG Server engine (new mode): a connection instead of an upload.
  const [serverUrl, setServerUrl] = useState("");
  const [apiKey, setApiKey] = useState("");
  const [retrievalMode, setRetrievalMode] = useState("");
  const [serverDefault, setServerDefault] = useState<{
    server_url: string;
    api_key_set: boolean;
  } | null>(null);
  const [engineDefaultSummary, setEngineDefaultSummary] = useState<string[]>(
    [],
  );
  const [serverProbe, setServerProbe] = useState<LightRagServerProbe | null>(
    null,
  );
  const [serverProbing, setServerProbing] = useState(false);
  const [weKnoraKnowledgeBaseId, setWeKnoraKnowledgeBaseId] = useState("");
  const [weKnoraProbe, setWeKnoraProbe] = useState<WeKnoraProbe | null>(null);
  const [weKnoraProbing, setWeKnoraProbing] = useState(false);
  const [submitting, setSubmitting] = useState(false);
  const [lightRagConfig, setLightRagConfig] = useState<Awaited<
    ReturnType<typeof getLightRagConfig>
  > | null>(null);
  const [lightRagConfigLoaded, setLightRagConfigLoaded] = useState(false);
  const [lightRagConfigError, setLightRagConfigError] = useState(false);
  const [error, setError] = useState<string | null>(null);
  const linkIsObsidian = linkSource === OBSIDIAN_SOURCE;
  const linkIsMarginNote = linkSource === MARGINNOTE4_SOURCE;
  const linkIsIma = linkSource === IMA_PROVIDER;
  const imaConnection = useImaConnection({
    name,
    onNameChange: setName,
    onError: setError,
    active: linkIsIma,
  });
  const llmCatalog = useLLMOptions(getLightRagModelOptions);
  const lightRagIndexingDefaults = lightRagConfig
    ? indexingSelectionFromDefaults(
        llmCatalog.options,
        lightRagConfig,
        llmCatalog.activeDefault,
      )
    : null;
  const lightRagModelLabel = (
    value?: {
      profile_id: string;
      model_id: string;
      reasoning_effort?: string;
    } | null,
  ) => {
    if (!value) return t("Disabled");
    const option = llmCatalog.options.find(
      (item) =>
        item.profile_id === value.profile_id &&
        item.model_id === value.model_id,
    );
    return `${option?.model_name ?? value.model_id} · ${value.reasoning_effort || t("Auto")}`;
  };
  const visibleEngineDefaultSummary =
    provider === "lightrag" && lightRagIndexingDefaults
      ? [
          ...engineDefaultSummary,
          ...(["query", "keyword", "extract", "vlm"] as const).map((role) => {
            const value = lightRagConfig?.role_models
              ? resolvedRole(lightRagConfig.role_models, role)
              : role === "vlm"
                ? lightRagIndexingDefaults.vlm.selection
                : lightRagIndexingDefaults.extract;
            return `${role.toUpperCase()}: ${lightRagModelLabel(value)}`;
          }),
        ]
      : engineDefaultSummary;
  const [defaultsRevision, setDefaultsRevision] = useState(0);
  const refreshCatalog = llmCatalog.refresh;

  useEffect(() => {
    if (!isOpen) return;
    const refresh = () => setDefaultsRevision((value) => value + 1);
    const onVisible = () => {
      if (document.visibilityState === "visible") refresh();
    };
    window.addEventListener("focus", refresh);
    window.addEventListener("pageshow", refresh);
    document.addEventListener("visibilitychange", onVisible);
    return () => {
      window.removeEventListener("focus", refresh);
      window.removeEventListener("pageshow", refresh);
      document.removeEventListener("visibilitychange", onVisible);
    };
  }, [isOpen]);

  const firstLinkable = providers.find((p) => p.linkable)?.id;

  const handleClose = () => {
    imaConnection.reset();
    onClose();
  };

  const handleModeChange = (nextMode: Mode) => {
    if (nextMode !== "link") imaConnection.reset();
    setMode(nextMode);
  };

  const handleLinkSourceChange = (source: string) => {
    if (source !== IMA_PROVIDER) imaConnection.reset();
    setLinkSource(source);
  };

  // Reset the form only on the closed → open transition. While the modal is
  // open, background indexing polls replace `providers` (and friends) every
  // few seconds, and a data refresh must never wipe user input (#691).
  const wasOpenRef = useRef(false);
  useEffect(() => {
    const justOpened = isOpen && !wasOpenRef.current;
    wasOpenRef.current = isOpen;
    if (!justOpened) return;
    setMode(initialMode);
    setName("");
    setFiles([]);
    setPageIndexMode("");
    setError(null);
    const initialProvider = createProviders(providers).find(
      (item) => item.id === initialSource,
    )?.id;
    setProvider(
      initialProvider || createProviders(providers)[0]?.id || "llamaindex",
    );
    setLinkSource(initialSource || firstLinkable || OBSIDIAN_SOURCE);
    setFolderPath("");
    setProbe(null);
    setProbing(false);
    setServerUrl("");
    setApiKey("");
    setRetrievalMode("");
    setServerDefault(null);
    setServerProbe(null);
    setServerProbing(false);
    setWeKnoraKnowledgeBaseId("");
    setWeKnoraProbe(null);
    setWeKnoraProbing(false);
    setLightRagConfig(null);
    setLightRagConfigLoaded(false);
    setLightRagConfigError(false);
  }, [isOpen, providers, firstLinkable, initialMode, initialSource]);

  useEffect(() => {
    if (!isOpen || mode !== "new") return;
    let cancelled = false;
    if (provider === "lightrag") {
      setLightRagConfig(null);
      setLightRagConfigLoaded(false);
      void refreshCatalog({ force: true });
    }

    const load = async () => {
      try {
        let summary: string[] = [];
        if (provider === "llamaindex") {
          const config = await getLlamaIndexConfig();
          summary = [
            `${t("Retrieval profile")}: ${config.retrieval_profile}`,
            `${t("Results per query")}: ${config.top_k}`,
            `${t("Chunk size")}: ${config.chunk_size} / ${t("Chunk overlap")}: ${config.chunk_overlap}`,
          ];
        } else if (provider === "graphrag") {
          const config = await getGraphRagConfig();
          summary = [
            `${t("Response style")}: ${config.response_type}`,
            `${t("Community level")}: ${config.community_level}`,
          ];
        } else if (provider === "lightrag") {
          const config = await getLightRagConfig({ force: true });
          if (!cancelled) {
            setLightRagConfig(config);
            setLightRagConfigLoaded(true);
            setLightRagConfigError(false);
          }
          summary = [
            `${t("Results per query")}: ${config.top_k}`,
            `${t("Files in parallel")}: ${config.max_concurrent_files}`,
            `${t("Extra extraction passes")}: ${config.entity_extract_max_gleaning}`,
          ];
        } else if (provider === "pageindex") {
          const config = await getPageIndexConfig();
          summary = [
            config.configured ? t("API key configured") : t("API key missing"),
          ];
        } else if (provider === LIGHTRAG_SERVER_PROVIDER) {
          const config = await getLightRagServerConfig();
          if (!cancelled) {
            setServerDefault(config);
            setServerUrl(config.server_url);
          }
          summary = [
            config.server_url || t("No default server URL"),
            config.api_key_set ? t("API key configured") : t("No API key"),
          ];
        } else if (provider === "pageindex-oss") {
          summary = [t("Uses the globally active chat model")];
        }
        if (!cancelled) setEngineDefaultSummary(summary);
      } catch {
        if (!cancelled) {
          setEngineDefaultSummary([]);
          if (provider === "lightrag") {
            setLightRagConfigLoaded(true);
            setLightRagConfigError(true);
          }
        }
      }
    };

    setEngineDefaultSummary([]);
    if (provider !== LIGHTRAG_SERVER_PROVIDER) setServerDefault(null);
    void load();
    return () => {
      cancelled = true;
    };
  }, [isOpen, mode, provider, t, defaultsRevision, refreshCatalog]);

  // A fresh path / source invalidates a stale probe verdict.
  useEffect(() => {
    setProbe(null);
  }, [folderPath, linkSource]);

  // A fresh URL / key invalidates a stale server connection test.
  useEffect(() => {
    setServerProbe(null);
  }, [serverUrl, apiKey]);

  // A fresh URL, key, or remote KB id invalidates a stale WeKnora verdict.
  useEffect(() => {
    setWeKnoraProbe(null);
  }, [serverUrl, apiKey, weKnoraKnowledgeBaseId]);

  // ---- New mode (build a fresh index) ----------------------------------
  const activeProvider = providers.find((p) => p.id === provider);
  const providerNeedsKey =
    !!activeProvider?.requires_api_key && activeProvider?.configured === false;
  const providerUnavailable = activeProvider?.configured === false;
  const isPageIndexCloud = provider === "pageindex";
  const isPageIndexOSS = provider === "pageindex-oss";
  const isLightRagServer = provider === LIGHTRAG_SERVER_PROVIDER;
  const isWeKnora = provider === WEKNORA_PROVIDER;
  const modeOptions = activeProvider?.modes ?? [];

  const policyForProvider = uploadPolicyForProvider(uploadPolicy, provider);

  const selection = validateFiles(files, policyForProvider, t);

  // ---- Link mode (mount an existing folder) ----------------------------
  const trimmed = name.trim();
  const trimmedPath = folderPath.trim();

  const trimmedServerUrl = serverUrl.trim();

  // Mirrors the backend rule so the name is rejected under the field rather
  // than as an English 400 after Create. The connect-* paths give no error at
  // all today, which is how a "/" name got registered in the first place.
  const nameProblems = forbiddenKbNameChars(trimmed);

  const needsEmbedding = ["llamaindex", "lightrag", "graphrag"].includes(
    provider,
  );
  const embeddingCatalog = useEmbeddingModels(
    undefined,
    isOpen && mode === "new" && needsEmbedding,
  );

  const canSubmit = (() => {
    if (submitting) return false;
    if (!trimmed) return false;
    if (!isValidKbName(trimmed)) return false;
    if (mode === "new") {
      if (isLightRagServer) {
        // The connection must pass the test before a KB is bound to it.
        return !!trimmedServerUrl && !!serverProbe?.ok;
      }
      if (isWeKnora) {
        return (
          !!trimmedServerUrl &&
          !!apiKey.trim() &&
          !!weKnoraKnowledgeBaseId.trim() &&
          !!weKnoraProbe?.ok
        );
      }
      if (
        provider === "lightrag" &&
        (!lightRagConfigLoaded ||
          lightRagConfigError ||
          llmCatalog.loading ||
          llmCatalog.error ||
          !isCompleteIndexingSelection(
            lightRagIndexingDefaults,
            llmCatalog.options,
          ))
      )
        return false;
      if (
        needsEmbedding &&
        (!embeddingCatalog.selection ||
          embeddingCatalog.loading ||
          embeddingCatalog.error)
      )
        return false;
      return !providerUnavailable;
    }
    if (linkIsIma) return imaConnection.canSubmit;
    if (linkIsMarginNote) return true;
    if (!trimmedPath) return false;
    if (linkIsObsidian) return true;
    // An engine index must pass the probe before it can be linked.
    return !!probe?.ok;
  })();

  const handleProbe = async () => {
    if (!trimmedPath || linkIsObsidian || probing) return;
    setProbing(true);
    setError(null);
    try {
      const result = await probeLinkedFolder({
        folderPath: trimmedPath,
        provider: linkSource,
      });
      setProbe(result);
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err));
    } finally {
      setProbing(false);
    }
  };

  const handleTestServer = async () => {
    if (!trimmedServerUrl || serverProbing) return;
    setServerProbing(true);
    setError(null);
    try {
      const result = await probeLightRagServer({
        serverUrl: trimmedServerUrl,
        apiKey: apiKey.trim(),
        useSavedApiKey:
          !apiKey.trim() &&
          !!serverDefault?.api_key_set &&
          trimmedServerUrl.replace(/\/+$/, "") === serverDefault.server_url,
      });
      setServerProbe(result);
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err));
    } finally {
      setServerProbing(false);
    }
  };

  const handleTestWeKnora = async () => {
    if (
      !trimmedServerUrl ||
      !apiKey.trim() ||
      !weKnoraKnowledgeBaseId.trim() ||
      weKnoraProbing
    ) {
      return;
    }
    setWeKnoraProbing(true);
    setError(null);
    try {
      const result = await probeWeKnora({
        serverUrl: trimmedServerUrl,
        apiKey: apiKey.trim(),
        knowledgeBaseId: weKnoraKnowledgeBaseId.trim(),
      });
      setWeKnoraProbe(result);
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err));
    } finally {
      setWeKnoraProbing(false);
    }
  };

  const handleSubmit = async () => {
    if (!canSubmit) return;
    setSubmitting(true);
    setError(null);
    try {
      if (mode === "new") {
        if (isLightRagServer) {
          await onConnectLightRagServer({
            name: trimmed,
            serverUrl: trimmedServerUrl,
            apiKey: apiKey.trim(),
            mode: retrievalMode,
          });
        } else if (isWeKnora) {
          await onConnectWeKnora({
            name: trimmed,
            serverUrl: trimmedServerUrl,
            apiKey: apiKey.trim(),
            knowledgeBaseId: weKnoraKnowledgeBaseId.trim(),
          });
        } else {
          await onCreate({
            name: trimmed,
            provider,
            files: selection.validFiles,
            // A new base is stored in the workspace the library is opened in.
            storageWorkspaceId: activeWorkspaceId(),
            pageindexMode:
              isPageIndexOSS && pageIndexMode ? pageIndexMode : undefined,
            searchMode: retrievalMode || undefined,
            embeddingModel: needsEmbedding
              ? embeddingCatalog.selection || undefined
              : undefined,
          });
        }
      } else if (linkIsIma) {
        await onConnectIma({
          name: trimmed,
          // Empty when the engine's account credentials are used — the server
          // resolves them and the KB stores no copy.
          clientId: imaConnection.submittedClientId,
          apiKey: imaConnection.submittedApiKey,
          knowledgeBaseId: imaConnection.knowledgeBaseId,
        });
      } else if (linkIsMarginNote) {
        await onConnectMarginNote4({ name: trimmed });
      } else if (linkIsObsidian) {
        await onConnectObsidian({ name: trimmed, vaultPath: trimmedPath });
      } else {
        await onConnectLinkedFolder({
          name: trimmed,
          folderPath: trimmedPath,
          provider: linkSource,
        });
      }
      handleClose();
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err));
    } finally {
      setSubmitting(false);
    }
  };

  const submitLabel =
    mode === "new"
      ? isLightRagServer || isWeKnora
        ? t("Connect")
        : t("Create")
      : linkIsObsidian || linkIsIma || linkIsMarginNote
        ? t("Connect")
        : t("Link");

  return (
    <Modal
      isOpen={isOpen}
      onClose={submitting ? () => {} : handleClose}
      title={t("Create knowledge base")}
      titleIcon={<Plus size={16} />}
      width="lg"
      closeOnBackdrop={!submitting}
      closeOnEscape={!submitting}
      footer={
        <div className="flex items-center justify-end gap-2">
          <button
            type="button"
            onClick={handleClose}
            disabled={submitting}
            className="rounded-md px-3 py-1.5 text-[12.5px] font-medium text-[var(--muted-foreground)] transition-colors hover:bg-[var(--muted)] hover:text-[var(--foreground)] disabled:opacity-40"
          >
            {t("Cancel")}
          </button>
          <button
            type="button"
            onClick={() => void handleSubmit()}
            disabled={!canSubmit}
            className="inline-flex items-center gap-1.5 rounded-md bg-[var(--primary)] px-3.5 py-1.5 text-[12.5px] font-medium text-[var(--primary-foreground)] transition-opacity hover:opacity-90 disabled:cursor-not-allowed disabled:opacity-40"
          >
            {submitting ? (
              <Loader2 className="h-3.5 w-3.5 animate-spin" />
            ) : mode === "new" && !isLightRagServer && !isWeKnora ? (
              <Plus size={14} />
            ) : (
              <Link2 size={14} />
            )}
            {submitLabel}
          </button>
        </div>
      }
    >
      <div className="space-y-4 px-5 py-4">
        {/* New vs. link existing */}
        <ModeToggle
          mode={mode}
          onChange={handleModeChange}
          disabled={submitting}
          t={t}
        />

        <div>
          <label className="mb-1 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
            {t("Knowledge base name")}
          </label>
          <input
            value={name}
            onChange={(event) => setName(event.target.value)}
            autoFocus
            disabled={submitting}
            placeholder={t("e.g. project-papers")}
            aria-invalid={nameProblems.length > 0}
            className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-3 py-2 text-[13px] text-[var(--foreground)] outline-none transition-colors focus:border-[var(--foreground)]/25 disabled:opacity-50"
          />
          {nameProblems.length > 0 && (
            <p className="mt-1 text-[11px] text-[var(--destructive)]">
              {t(
                "A knowledge base name cannot contain {{chars}} — these separate paths and URLs.",
                { chars: nameProblems.join(" ") },
              )}
            </p>
          )}
        </div>

        {mode === "new" ? (
          <NewModeFields
            providers={createProviders(providers)}
            provider={provider}
            setProvider={setProvider}
            submitting={submitting}
            providerUnavailable={providerUnavailable}
            providerNeedsKey={providerNeedsKey}
            onConfigureProvider={onConfigureProvider}
            activeProvider={activeProvider}
            engineDefaultSummary={visibleEngineDefaultSummary}
            modeOptions={modeOptions}
            retrievalMode={retrievalMode}
            setRetrievalMode={setRetrievalMode}
            isPageIndexCloud={isPageIndexCloud}
            isPageIndexOSS={isPageIndexOSS}
            pageIndexMode={pageIndexMode}
            setPageIndexMode={setPageIndexMode}
            files={files}
            setFiles={setFiles}
            policyForProvider={policyForProvider}
            indexingModelField={
              <div className="space-y-4">
                {needsEmbedding && (
                  <EmbeddingModelSelector
                    catalog={embeddingCatalog}
                    disabled={submitting}
                  />
                )}
                {provider === "lightrag" &&
                (lightRagConfigError ||
                  llmCatalog.error ||
                  (lightRagConfigLoaded &&
                    !llmCatalog.loading &&
                    !isCompleteIndexingSelection(
                      lightRagIndexingDefaults,
                      llmCatalog.options,
                    ))) ? (
                  <p role="alert" className="text-[12px] text-red-600">
                    {t(
                      "Configure valid LightRAG defaults in Settings before creating a knowledge base.",
                    )}
                  </p>
                ) : null}
              </div>
            }
            connectionForm={
              isLightRagServer ? (
                <LightRagServerFields
                  serverUrl={serverUrl}
                  setServerUrl={setServerUrl}
                  apiKey={apiKey}
                  setApiKey={setApiKey}
                  hasSavedApiKey={!!serverDefault?.api_key_set}
                  usingSavedDefault={
                    !!serverDefault?.server_url &&
                    serverUrl.trim().replace(/\/+$/, "") ===
                      serverDefault.server_url
                  }
                  submitting={submitting}
                  probing={serverProbing}
                  probe={serverProbe}
                  onTest={handleTestServer}
                  t={t}
                />
              ) : isWeKnora ? (
                <WeKnoraFields
                  serverUrl={serverUrl}
                  setServerUrl={setServerUrl}
                  apiKey={apiKey}
                  setApiKey={setApiKey}
                  knowledgeBaseId={weKnoraKnowledgeBaseId}
                  setKnowledgeBaseId={setWeKnoraKnowledgeBaseId}
                  submitting={submitting}
                  probing={weKnoraProbing}
                  probe={weKnoraProbe}
                  onTest={handleTestWeKnora}
                  t={t}
                />
              ) : null
            }
            t={t}
          />
        ) : (
          <LinkModeFields
            providers={providers}
            linkSource={linkSource}
            setLinkSource={handleLinkSourceChange}
            linkIsObsidian={linkIsObsidian}
            linkIsIma={linkIsIma}
            linkIsMarginNote={linkIsMarginNote}
            folderPath={folderPath}
            setFolderPath={setFolderPath}
            submitting={submitting}
            probing={probing}
            probe={probe}
            onProbe={handleProbe}
            connectionForm={
              linkIsIma ? (
                <ImaConnectionFields
                  connection={imaConnection}
                  submitting={submitting}
                />
              ) : null
            }
            t={t}
          />
        )}

        {error && (
          <div className="rounded-lg border border-red-200 bg-red-50 px-3 py-2 text-[12px] text-red-700 dark:border-red-900 dark:bg-red-950/30 dark:text-red-300">
            <pre className="whitespace-pre-wrap break-words font-mono text-[11px] leading-relaxed">
              {error}
            </pre>
          </div>
        )}
      </div>
    </Modal>
  );
}

type TFn = (key: string, options?: Record<string, unknown>) => string;

function ModeToggle({
  mode,
  onChange,
  disabled,
  t,
}: {
  mode: Mode;
  onChange: (mode: Mode) => void;
  disabled: boolean;
  t: TFn;
}) {
  const options: {
    id: Mode;
    label: string;
    hint: string;
    icon: typeof Plus;
  }[] = [
    {
      id: "new",
      label: t("Create new"),
      hint: t("Upload documents and build a fresh index."),
      icon: Plus,
    },
    {
      id: "link",
      label: t("Link existing"),
      hint: t(
        "Reuse an index you already built — read in place, no upload or re-index.",
      ),
      icon: Link2,
    },
  ];
  return (
    <div className="grid grid-cols-2 gap-2">
      {options.map((opt) => {
        const selected = mode === opt.id;
        const Icon = opt.icon;
        return (
          <button
            key={opt.id}
            type="button"
            disabled={disabled}
            onClick={() => onChange(opt.id)}
            className={`flex flex-col gap-1 rounded-2xl border p-3 text-left transition-colors disabled:opacity-50 ${
              selected
                ? "border-[var(--primary)] bg-[var(--primary)]/5"
                : "border-[var(--border)] hover:border-[var(--ring)]"
            }`}
          >
            <span className="flex items-center gap-1.5 text-[13px] font-medium text-[var(--foreground)]">
              <Icon className="h-3.5 w-3.5" />
              {opt.label}
            </span>
            <span className="text-[11px] leading-snug text-[var(--muted-foreground)]">
              {opt.hint}
            </span>
          </button>
        );
      })}
    </div>
  );
}

function NewModeFields({
  providers,
  provider,
  setProvider,
  activeProvider,
  engineDefaultSummary,
  modeOptions,
  retrievalMode,
  setRetrievalMode,
  submitting,
  providerUnavailable,
  providerNeedsKey,
  onConfigureProvider,
  isPageIndexCloud,
  isPageIndexOSS,
  pageIndexMode,
  setPageIndexMode,
  files,
  setFiles,
  policyForProvider,
  indexingModelField,
  connectionForm,
  t,
}: {
  providers: RagProviderSummary[];
  provider: string;
  setProvider: (id: string) => void;
  activeProvider?: RagProviderSummary;
  engineDefaultSummary: string[];
  modeOptions: string[];
  retrievalMode: string;
  setRetrievalMode: (mode: string) => void;
  submitting: boolean;
  providerUnavailable: boolean;
  providerNeedsKey: boolean;
  onConfigureProvider?: (providerId: string) => void;
  isPageIndexCloud: boolean;
  isPageIndexOSS: boolean;
  pageIndexMode: "" | "flash" | "standard";
  setPageIndexMode: (mode: "" | "flash" | "standard") => void;
  files: File[];
  setFiles: (files: File[]) => void;
  policyForProvider: KnowledgeUploadPolicy;
  indexingModelField?: ReactNode;
  /** When set, replaces the upload step (e.g. a server connection form). */
  connectionForm?: ReactNode;
  t: TFn;
}) {
  const readinessReason = providers.find(
    (item) => item.id === provider,
  )?.readiness_reason;
  return (
    <>
      <div>
        <label className="mb-1.5 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
          {t("Index engine")}
        </label>
        <div className="grid gap-2 sm:grid-cols-2">
          {providers.map((p) => {
            const selected = provider === p.id;
            const needsKey = !!p.requires_api_key && p.configured === false;
            const unavailable = p.configured === false && !p.requires_api_key;
            return (
              <div key={p.id} className="flex flex-col gap-1">
                <button
                  type="button"
                  disabled={submitting}
                  onClick={() => {
                    setProvider(p.id);
                    setRetrievalMode("");
                  }}
                  className={`group flex w-full flex-1 flex-col gap-1 rounded-2xl border p-3 text-left transition-colors disabled:opacity-50 ${
                    selected
                      ? "border-[var(--primary)] bg-[var(--primary)]/5"
                      : "border-[var(--border)] hover:border-[var(--ring)]"
                  }`}
                >
                  <div className="flex items-center justify-between gap-2">
                    <span className="flex min-w-0 items-center gap-2 text-[13px] font-medium text-[var(--foreground)]">
                      <KnowledgeEngineIcon engine={p.id} size={24} />
                      <span className="truncate">{p.name}</span>
                    </span>
                    {needsKey ? (
                      <span className="inline-flex items-center gap-1 rounded-full bg-amber-100 px-1.5 py-0.5 text-[10px] font-medium text-amber-700 dark:bg-amber-950/30 dark:text-amber-300">
                        {t("Needs key")}
                      </span>
                    ) : unavailable ? (
                      <span className="inline-flex items-center gap-1 rounded-full bg-[var(--muted)] px-1.5 py-0.5 text-[10px] font-medium text-[var(--muted-foreground)]">
                        {t("Not installed")}
                      </span>
                    ) : selected ? (
                      <Check className="h-3.5 w-3.5 text-[var(--primary)]" />
                    ) : null}
                  </div>
                  <span className="text-[11.5px] leading-snug text-[var(--muted-foreground)]">
                    {p.description}
                  </span>
                </button>
                {p.id === "pageindex" && (
                  <a
                    href="https://dash.pageindex.ai/api-keys"
                    target="_blank"
                    rel="noreferrer"
                    className="inline-flex items-center gap-1 px-1 text-[10.5px] text-[var(--muted-foreground)] hover:text-[var(--foreground)]"
                  >
                    {t("PageIndex API plans")}
                    <ExternalLink className="h-3 w-3" />
                  </a>
                )}
              </div>
            );
          })}
        </div>
        {providerUnavailable && (
          <div className="mt-2 flex items-center justify-between gap-2 rounded-lg border border-amber-200 bg-amber-50 px-3 py-2 text-[12px] text-amber-800 dark:border-amber-900 dark:bg-amber-950/30 dark:text-amber-200">
            <span className="flex items-center gap-1.5">
              <AlertTriangle className="h-3.5 w-3.5 shrink-0" />
              {providerNeedsKey
                ? t(
                    "This engine needs an API key. Configure it before creating.",
                  )
                : t(
                    readinessReason ||
                      "This engine isn't ready on the server. Check its requirements before creating.",
                  )}
            </span>
            {providerNeedsKey && onConfigureProvider && (
              <button
                type="button"
                onClick={() => onConfigureProvider(provider)}
                className="shrink-0 rounded-md px-2 py-1 text-[11.5px] font-medium text-amber-900 underline-offset-2 hover:underline dark:text-amber-100"
              >
                {t("Configure")}
              </button>
            )}
          </div>
        )}
      </div>

      {activeProvider && (
        <div className="rounded-xl border border-[var(--border)] bg-[var(--muted)]/25 p-3">
          <div className="flex items-start justify-between gap-3">
            <div>
              <div className="text-[12px] font-medium text-[var(--foreground)]">
                {t("Engine defaults")}
              </div>
              <p className="mt-0.5 text-[11px] leading-relaxed text-[var(--muted-foreground)]">
                {t(
                  "This knowledge base starts with the saved engine configuration.",
                )}
              </p>
            </div>
            {onConfigureProvider && (
              <button
                type="button"
                onClick={() => onConfigureProvider(provider)}
                className="inline-flex shrink-0 items-center gap-1 text-[11.5px] font-medium text-[var(--primary)] hover:underline"
              >
                {t("Edit defaults")}
                <ChevronRight className="h-3 w-3" />
              </button>
            )}
          </div>
          {engineDefaultSummary.length > 0 && (
            <div className="mt-2 flex flex-wrap gap-1.5">
              {engineDefaultSummary.map((item) => (
                <span
                  key={item}
                  className="rounded-md border border-[var(--border)] bg-[var(--background)] px-2 py-1 text-[10.5px] text-[var(--muted-foreground)]"
                >
                  {item}
                </span>
              ))}
            </div>
          )}
        </div>
      )}

      {indexingModelField && <div>{indexingModelField}</div>}

      {modeOptions.length > 0 && (
        <div>
          <label className="mb-1 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
            {t("Retrieval mode")}
          </label>
          <select
            value={retrievalMode}
            onChange={(event) => setRetrievalMode(event.target.value)}
            disabled={submitting}
            className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-3 py-2 text-[12.5px] text-[var(--foreground)] outline-none transition-colors focus:border-[var(--foreground)]/25 disabled:opacity-50"
          >
            <option value="">
              {t("Use engine default: {{mode}}", {
                mode: activeProvider?.default_mode || modeOptions[0],
              })}
            </option>
            {modeOptions.map((item) => (
              <option key={item} value={item}>
                {item}
              </option>
            ))}
          </select>
          <p className="mt-1 text-[11px] text-[var(--muted-foreground)]">
            {t(
              "This override applies only to this knowledge base; the engine default stays unchanged.",
            )}
          </p>
        </div>
      )}

      {isPageIndexOSS && (
        <div>
          <label className="mb-1 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
            {t("Index mode")}
            <span className="ml-2 normal-case tracking-normal text-[var(--muted-foreground)]/80">
              · {t("optional")}
            </span>
          </label>
          <select
            value={pageIndexMode}
            onChange={(event) =>
              setPageIndexMode(event.target.value as "" | "flash" | "standard")
            }
            disabled={submitting}
            className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-3 py-2 text-[12.5px] text-[var(--foreground)] outline-none transition-colors focus:border-[var(--foreground)]/25 disabled:opacity-50"
          >
            <option value="">
              {t("Default — Flash, summaries and full optimization")}
            </option>
            <option value="flash">{t("Flash")}</option>
            <option value="standard">{t("Standard")}</option>
          </select>
          <p className="mt-1 text-[11px] text-[var(--muted-foreground)]">
            {t(
              "Uses the globally active LLM credential. Leaving this unset delegates to the PageIndex SDK default.",
            )}
          </p>
        </div>
      )}

      {connectionForm ?? (
        <div>
          <label className="mb-2 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
            {t("Initial documents")}
            <span className="ml-1 normal-case tracking-normal text-[var(--muted-foreground)]/80">
              ({t("optional")})
            </span>
            {(isPageIndexCloud || isPageIndexOSS) && (
              <span className="ml-2 normal-case tracking-normal text-[var(--muted-foreground)]/80">
                ·{" "}
                {isPageIndexOSS
                  ? t(
                      "PDF only — use PageIndex Cloud for Office, Markdown or CSV",
                    )
                  : t("PDF, Office, text and Markdown")}
              </span>
            )}
          </label>
          <FileDropZone
            files={files}
            onChange={setFiles}
            uploadPolicy={policyForProvider}
            disabled={submitting}
          />
          <p className="mt-1.5 text-[11px] text-[var(--muted-foreground)]">
            {t(
              "Skip for now — you can add GitHub sources or upload documents after creation.",
            )}
          </p>
        </div>
      )}
    </>
  );
}

function LightRagServerFields({
  serverUrl,
  setServerUrl,
  apiKey,
  setApiKey,
  hasSavedApiKey,
  usingSavedDefault,
  submitting,
  probing,
  probe,
  onTest,
  t,
}: {
  serverUrl: string;
  setServerUrl: (value: string) => void;
  apiKey: string;
  setApiKey: (value: string) => void;
  hasSavedApiKey: boolean;
  usingSavedDefault: boolean;
  submitting: boolean;
  probing: boolean;
  probe: LightRagServerProbe | null;
  onTest: () => void;
  t: TFn;
}) {
  return (
    <div className="space-y-3">
      <div>
        <label className="mb-1 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
          {t("Server URL")}
        </label>
        <div className="flex gap-2">
          <input
            value={serverUrl}
            onChange={(event) => setServerUrl(event.target.value)}
            disabled={submitting}
            placeholder={EXAMPLE_SERVER_URL}
            className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-3 py-2 font-mono text-[12.5px] text-[var(--foreground)] outline-none transition-colors focus:border-[var(--foreground)]/25 disabled:opacity-50"
          />
          <button
            type="button"
            onClick={onTest}
            disabled={submitting || probing || serverUrl.trim().length === 0}
            className="inline-flex shrink-0 items-center gap-1.5 rounded-lg border border-[var(--border)] px-3 text-[12px] font-medium text-[var(--foreground)] transition-colors hover:border-[var(--ring)] disabled:cursor-not-allowed disabled:opacity-40"
          >
            {probing ? (
              <Loader2 className="h-3.5 w-3.5 animate-spin" />
            ) : (
              <Server className="h-3.5 w-3.5" />
            )}
            {t("Test connection")}
          </button>
        </div>
        <p className="mt-1 text-[11px] text-[var(--muted-foreground)]">
          {t(
            "The base URL of your running LightRAG server. Documents are indexed there — nothing is uploaded or copied.",
          )}
        </p>
        {usingSavedDefault && (
          <p className="mt-1 inline-flex items-center gap-1 text-[11px] font-medium text-emerald-700 dark:text-emerald-300">
            <Check className="h-3 w-3" />
            {t("Using saved engine default · editable for this KB")}
          </p>
        )}
      </div>

      <div>
        <label className="mb-1 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
          {t("API key")}
          <span className="ml-2 normal-case tracking-normal text-[var(--muted-foreground)]/80">
            · {t("optional")}
          </span>
        </label>
        <input
          value={apiKey}
          onChange={(event) => setApiKey(event.target.value)}
          disabled={submitting}
          type="password"
          autoComplete="off"
          placeholder={t("Only if your server requires one")}
          className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-3 py-2 text-[12.5px] text-[var(--foreground)] outline-none transition-colors focus:border-[var(--foreground)]/25 disabled:opacity-50"
        />
      </div>

      {hasSavedApiKey && !apiKey && usingSavedDefault && (
        <p className="-mt-2 text-[11px] text-[var(--muted-foreground)]">
          {t(
            "The saved API key will be used. Enter a value only to override it.",
          )}
        </p>
      )}

      {probe && <ServerProbeVerdict probe={probe} t={t} />}
    </div>
  );
}

function ServerProbeVerdict({
  probe,
  t,
}: {
  probe: LightRagServerProbe;
  t: TFn;
}) {
  if (!probe.ok) {
    return (
      <div className="rounded-lg border border-red-200 bg-red-50 px-3 py-2 text-[12px] text-red-700 dark:border-red-900 dark:bg-red-950/30 dark:text-red-300">
        <span className="flex items-center gap-1.5 font-medium">
          <AlertTriangle className="h-3.5 w-3.5 shrink-0" />
          {t("Could not connect")}
        </span>
        {probe.error && <p className="mt-1 leading-relaxed">{probe.error}</p>}
      </div>
    );
  }
  return (
    <div className="space-y-1 rounded-lg border border-[var(--border)] bg-[var(--muted)]/40 px-3 py-2.5 text-[12px]">
      <div className="flex items-center gap-1.5 font-medium text-emerald-700 dark:text-emerald-300">
        <Check className="h-3.5 w-3.5 shrink-0" />
        {t("Connected to LightRAG server")}
      </div>
      <div className="flex flex-wrap items-center gap-x-3 gap-y-1 text-[11.5px] text-[var(--muted-foreground)]">
        {probe.core_version && (
          <span>{t("Core {{version}}", { version: probe.core_version })}</span>
        )}
        <span>
          {probe.auth_required ? t("API key accepted") : t("Open access")}
        </span>
      </div>
    </div>
  );
}

function WeKnoraFields({
  serverUrl,
  setServerUrl,
  apiKey,
  setApiKey,
  knowledgeBaseId,
  setKnowledgeBaseId,
  submitting,
  probing,
  probe,
  onTest,
  t,
}: {
  serverUrl: string;
  setServerUrl: (value: string) => void;
  apiKey: string;
  setApiKey: (value: string) => void;
  knowledgeBaseId: string;
  setKnowledgeBaseId: (value: string) => void;
  submitting: boolean;
  probing: boolean;
  probe: WeKnoraProbe | null;
  onTest: () => void;
  t: TFn;
}) {
  const testDisabled =
    submitting ||
    probing ||
    serverUrl.trim().length === 0 ||
    apiKey.trim().length === 0 ||
    knowledgeBaseId.trim().length === 0;

  return (
    <div className="space-y-3">
      <div>
        <label className="mb-1 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
          {t("Server URL")}
        </label>
        <div className="flex gap-2">
          <input
            value={serverUrl}
            onChange={(event) => setServerUrl(event.target.value)}
            disabled={submitting}
            placeholder={EXAMPLE_SERVER_URL}
            className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-3 py-2 font-mono text-[12.5px] text-[var(--foreground)] outline-none transition-colors focus:border-[var(--foreground)]/25 disabled:opacity-50"
          />
          <button
            type="button"
            onClick={onTest}
            disabled={testDisabled}
            className="inline-flex shrink-0 items-center gap-1.5 rounded-lg border border-[var(--border)] px-3 text-[12px] font-medium text-[var(--foreground)] transition-colors hover:border-[var(--ring)] disabled:cursor-not-allowed disabled:opacity-40"
          >
            {probing ? (
              <Loader2 className="h-3.5 w-3.5 animate-spin" />
            ) : (
              <Server className="h-3.5 w-3.5" />
            )}
            {t("Test connection")}
          </button>
        </div>
        <p className="mt-1 text-[11px] text-[var(--muted-foreground)]">
          {t(
            "The base URL of your self-hosted WeKnora deployment. Documents remain there; DeepTutor only runs retrieval searches.",
          )}
        </p>
      </div>

      <div>
        <label className="mb-1 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
          {t("WeKnora API key")}
        </label>
        <input
          value={apiKey}
          onChange={(event) => setApiKey(event.target.value)}
          disabled={submitting}
          type="password"
          autoComplete="off"
          placeholder={t("Required to access your WeKnora knowledge base")}
          className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-3 py-2 text-[12.5px] text-[var(--foreground)] outline-none transition-colors focus:border-[var(--foreground)]/25 disabled:opacity-50"
        />
      </div>

      <div>
        <label className="mb-1 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
          {t("WeKnora knowledge base ID")}
        </label>
        <div className="relative">
          <Database className="pointer-events-none absolute left-3 top-1/2 h-3.5 w-3.5 -translate-y-1/2 text-[var(--muted-foreground)]" />
          <input
            value={knowledgeBaseId}
            onChange={(event) => setKnowledgeBaseId(event.target.value)}
            disabled={submitting}
            placeholder={t("WeKnora knowledge base ID")}
            className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] py-2 pl-9 pr-3 font-mono text-[12.5px] text-[var(--foreground)] outline-none transition-colors focus:border-[var(--foreground)]/25 disabled:opacity-50"
          />
        </div>
      </div>

      {probe && <WeKnoraProbeVerdict probe={probe} t={t} />}
    </div>
  );
}

function WeKnoraProbeVerdict({ probe, t }: { probe: WeKnoraProbe; t: TFn }) {
  if (!probe.ok) {
    return (
      <div className="rounded-lg border border-red-200 bg-red-50 px-3 py-2 text-[12px] text-red-700 dark:border-red-900 dark:bg-red-950/30 dark:text-red-300">
        <span className="flex items-center gap-1.5 font-medium">
          <AlertTriangle className="h-3.5 w-3.5 shrink-0" />
          {t("Could not connect")}
        </span>
        {probe.error && <p className="mt-1 leading-relaxed">{probe.error}</p>}
      </div>
    );
  }

  return (
    <div className="space-y-1 rounded-lg border border-[var(--border)] bg-[var(--muted)]/40 px-3 py-2.5 text-[12px]">
      <div className="flex items-center gap-1.5 font-medium text-emerald-700 dark:text-emerald-300">
        <Check className="h-3.5 w-3.5 shrink-0" />
        {t("Connected to WeKnora")}
      </div>
      <div className="text-[11.5px] text-[var(--muted-foreground)]">
        {probe.knowledge_base_name
          ? t("Knowledge base {{name}}", {
              name: probe.knowledge_base_name,
            })
          : probe.knowledge_base_id}
      </div>
    </div>
  );
}

function LinkModeFields({
  providers,
  linkSource,
  setLinkSource,
  linkIsObsidian,
  linkIsIma,
  linkIsMarginNote,
  folderPath,
  setFolderPath,
  submitting,
  probing,
  probe,
  onProbe,
  connectionForm,
  t,
}: {
  providers: RagProviderSummary[];
  linkSource: string;
  setLinkSource: (id: string) => void;
  linkIsObsidian: boolean;
  linkIsIma: boolean;
  linkIsMarginNote: boolean;
  folderPath: string;
  setFolderPath: (value: string) => void;
  submitting: boolean;
  probing: boolean;
  probe: LinkedFolderProbe | null;
  onProbe: () => void;
  connectionForm?: ReactNode;
  t: TFn;
}) {
  return (
    <>
      <div>
        <label className="mb-1.5 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
          {t("Source")}
        </label>
        <div className="grid gap-2 sm:grid-cols-2">
          {providers.map((p) => {
            const selected =
              !linkIsObsidian && !linkIsMarginNote && linkSource === p.id;
            const enabled = linkSourceEnabled(p);
            const disabled = submitting || !enabled;
            return (
              <Tooltip
                key={p.id}
                label={enabled ? p.name : t("This engine's index lives in the cloud and can't be linked.")}
                suppressed={enabled}
                side="top"
              >
                <button
                  type="button"
                  disabled={disabled}
                  onClick={() => setLinkSource(p.id)}
                  aria-label={p.name}
                  className={`group flex h-full w-full flex-col gap-1 rounded-2xl border p-3 text-left transition-colors disabled:cursor-not-allowed disabled:opacity-50 ${
                    selected
                      ? "border-[var(--primary)] bg-[var(--primary)]/5"
                      : "border-[var(--border)] hover:border-[var(--ring)]"
                  }`}
                >
                  <div className="flex items-center justify-between gap-2">
                    <span className="flex min-w-0 items-center gap-2 text-[13px] font-medium text-[var(--foreground)]">
                      <KnowledgeEngineIcon engine={p.id} size={24} />
                      <span className="truncate">{p.name}</span>
                    </span>
                    {selected ? (
                      <Check className="h-3.5 w-3.5 text-[var(--primary)]" />
                    ) : !enabled ? (
                      <span className="inline-flex items-center gap-1 rounded-full bg-[var(--muted)] px-1.5 py-0.5 text-[10px] font-medium text-[var(--muted-foreground)]">
                        {t("Cloud index")}
                      </span>
                    ) : p.id === IMA_PROVIDER ? (
                      <span className="inline-flex items-center gap-1 rounded-full bg-sky-100 px-1.5 py-0.5 text-[10px] font-medium text-sky-700 dark:bg-sky-950/30 dark:text-sky-300">
                        {t("Read only")}
                      </span>
                    ) : null}
                  </div>
                  <span className="text-[11.5px] leading-snug text-[var(--muted-foreground)]">
                    {p.description}
                  </span>
                </button>
              </Tooltip>
            );
          })}

          {/* Obsidian — a live vault, no index. */}
          <button
            type="button"
            disabled={submitting}
            onClick={() => setLinkSource(OBSIDIAN_SOURCE)}
            className={`group flex flex-col gap-1 rounded-2xl border p-3 text-left transition-colors disabled:opacity-50 ${
              linkIsObsidian
                ? "border-[var(--primary)] bg-[var(--primary)]/5"
                : "border-[var(--border)] hover:border-[var(--ring)]"
            }`}
          >
            <div className="flex items-center justify-between gap-2">
              <span className="flex items-center gap-2 text-[13px] font-medium text-[var(--foreground)]">
                <KnowledgeEngineIcon engine="obsidian" size={24} />
                {t("Obsidian")}
              </span>
              {linkIsObsidian && (
                <Check className="h-3.5 w-3.5 text-[var(--primary)]" />
              )}
            </div>
            <span className="text-[11.5px] leading-snug text-[var(--muted-foreground)]">
              {t(
                "A live Obsidian vault — browsed and edited in place, no index.",
              )}
            </span>
          </button>

          {/* MarginNote 4 — filled by its Add-on, not by a path on this disk. */}
          <button
            type="button"
            disabled={submitting}
            onClick={() => setLinkSource(MARGINNOTE4_SOURCE)}
            className={`group flex flex-col gap-1 rounded-2xl border p-3 text-left transition-colors disabled:opacity-50 ${
              linkIsMarginNote
                ? "border-[var(--primary)] bg-[var(--primary)]/5"
                : "border-[var(--border)] hover:border-[var(--ring)]"
            }`}
          >
            <div className="flex items-center justify-between gap-2">
              <span className="flex items-center gap-2 text-[13px] font-medium text-[var(--foreground)]">
                <KnowledgeEngineIcon engine="marginnote4" size={24} />
                {t("MarginNote 4")}
              </span>
              {linkIsMarginNote && (
                <Check className="h-3.5 w-3.5 text-[var(--primary)]" />
              )}
            </div>
            <span className="text-[11.5px] leading-snug text-[var(--muted-foreground)]">
              {t(
                "Notes, excerpts and cards pushed in by the MarginNote 4 add-on.",
              )}
            </span>
          </button>
        </div>
      </div>

      {linkIsIma ? (
        connectionForm
      ) : linkIsMarginNote ? (
        <p className="rounded-lg border border-[var(--border)] bg-[var(--muted)]/40 px-3 py-2 text-[11.5px] leading-relaxed text-[var(--muted-foreground)]">
          {t(
            "The library starts empty. Pair a device from its Devices tab, then enter the token in the MarginNote 4 add-on to start syncing.",
          )}
        </p>
      ) : (
        <>
          <div>
            <label className="mb-1 block text-[11px] font-medium uppercase tracking-wide text-[var(--muted-foreground)]">
              {linkIsObsidian ? t("Vault path") : t("Folder path")}
            </label>
            <div className="flex gap-2">
              <input
                value={folderPath}
                onChange={(event) => setFolderPath(event.target.value)}
                disabled={submitting}
                placeholder={
                  linkIsObsidian ? EXAMPLE_VAULT_PATH : EXAMPLE_INDEX_PATH
                }
                className="w-full rounded-lg border border-[var(--border)] bg-[var(--background)] px-3 py-2 font-mono text-[12.5px] text-[var(--foreground)] outline-none transition-colors focus:border-[var(--foreground)]/25 disabled:opacity-50"
              />
              {!linkIsObsidian && (
                <button
                  type="button"
                  onClick={onProbe}
                  disabled={
                    submitting || probing || folderPath.trim().length === 0
                  }
                  className="inline-flex shrink-0 items-center gap-1.5 rounded-lg border border-[var(--border)] px-3 text-[12px] font-medium text-[var(--foreground)] transition-colors hover:border-[var(--ring)] disabled:cursor-not-allowed disabled:opacity-40"
                >
                  {probing ? (
                    <Loader2 className="h-3.5 w-3.5 animate-spin" />
                  ) : (
                    <FolderSearch className="h-3.5 w-3.5" />
                  )}
                  {t("Check folder")}
                </button>
              )}
            </div>
            <p className="mt-1 text-[11px] text-[var(--muted-foreground)]">
              {linkIsObsidian
                ? t("The absolute path to the vault folder on this machine.")
                : t(
                    "The absolute path to a knowledge base folder on this machine — nothing is copied.",
                  )}
            </p>
          </div>

          {!linkIsObsidian && probe && <ProbeVerdict probe={probe} t={t} />}
        </>
      )}
    </>
  );
}

function ProbeVerdict({ probe, t }: { probe: LinkedFolderProbe; t: TFn }) {
  if (!probe.ok) {
    return (
      <div className="rounded-lg border border-red-200 bg-red-50 px-3 py-2 text-[12px] text-red-700 dark:border-red-900 dark:bg-red-950/30 dark:text-red-300">
        <span className="flex items-center gap-1.5 font-medium">
          <AlertTriangle className="h-3.5 w-3.5 shrink-0" />
          {t("This folder can't be linked")}
        </span>
        {probe.error && <p className="mt-1 leading-relaxed">{probe.error}</p>}
      </div>
    );
  }

  const compatible = probe.embedding.compatible;
  return (
    <div className="space-y-2 rounded-lg border border-[var(--border)] bg-[var(--muted)]/40 px-3 py-2.5 text-[12px]">
      <div className="flex items-center gap-1.5 font-medium text-emerald-700 dark:text-emerald-300">
        <Check className="h-3.5 w-3.5 shrink-0" />
        {t("Ready index found")}
      </div>
      <div className="flex flex-wrap items-center gap-x-3 gap-y-1 text-[11.5px] text-[var(--muted-foreground)]">
        {probe.version && <span className="font-mono">{probe.version}</span>}
        {probe.doc_count != null && (
          <span>{t("{{count}} documents", { count: probe.doc_count })}</span>
        )}
        {compatible === true && (
          <span className="inline-flex items-center gap-1 text-emerald-700 dark:text-emerald-300">
            <Check className="h-3 w-3" />
            {t("Embedding model matches")}
          </span>
        )}
      </div>
      {probe.warnings.map((warning, index) => (
        <p
          key={index}
          className="flex items-start gap-1.5 leading-relaxed text-amber-700 dark:text-amber-300"
        >
          <AlertTriangle className="mt-0.5 h-3.5 w-3.5 shrink-0" />
          <span>{warning}</span>
        </p>
      ))}
    </div>
  );
}