DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.
Python ai-agentsai-tutorclawbotcli-tooldeepresearchinteractive-learninglearningmulti-agent-systemsrag
"use client";
import { knowledgeBaseRef } from "@/lib/knowledge-helpers";
import Link from "next/link";
import { useEffect, useRef, useState } from "react";
import { Check, ChevronDown, Database } from "lucide-react";
import { useTranslation } from "react-i18next";
import { useLingerExpand } from "@/hooks/use-linger-expand";
import { useOutsideClick } from "@/hooks/use-outside-click";
/**
* Knowledge-base scope selector (composer toolbar).
*
* A collapse-to-icon chip + dropdown, because a
* KB selection is the same KIND of state: a SESSION-level retrieval
* scope that persists across turns (stored in session.preferences),
* NOT a one-shot reference like an attachment. Surfacing it as a
* persistent toolbar chip — rather than burying it in the "+" menu —
* makes that stickiness legible: the active scope sits in the toolbar
* before every message and is one click away from being changed.
*
* Multi-select: rows toggle without closing, so several bases can be
* picked in one pass. A non-empty selection tints the icon primary so
* the active scope stays visible even when the chip is collapsed.
*/
export default function KnowledgeSelector({
knowledgeBases,
selected,
onToggle,
placement = "top",
pinned = false,
embedded = false,
}: {
knowledgeBases: { id?: string; name: string; provenance_label?: string }[];
selected: string[];
onToggle: (name: string) => void;
placement?: "top" | "bottom";
/** Keep the label visible instead of collapsing to the icon at rest.
* Set by the composer rail, where there is room for it. */
pinned?: boolean;
/** Render the picker contents inside a shared resource panel. */
embedded?: boolean;
}) {
const { t } = useTranslation();
const [openState, setOpenState] = useState(false);
const open = embedded || openState;
const {
expanded,
linger,
triggerProps: lingerProps,
} = useLingerExpand(open, 1200, pinned);
const setOpen = (next: boolean) => {
setOpenState(next);
// Keep the label expanded for a beat after close so a just-made
// change registers before the chip collapses.
if (!next) linger();
};
const rootRef = useRef<HTMLDivElement>(null);
const [query, setQuery] = useState("");
// Close on outside click.
useOutsideClick(rootRef, open, () => setOpen(false));
const count = selected.length;
const label =
count === 0
? t("Knowledge")
: count === 1
? (knowledgeBases.find((kb) => knowledgeBaseRef(kb) === selected[0])
?.name ?? selected[0])
: `${count} ${t("knowledge bases")}`;
const menuPlacementClass =
placement === "bottom" ? "top-full mt-1.5" : "bottom-full mb-1.5";
return (
<div ref={rootRef} className="relative">
{/* Resting state is just the database icon; hovering (or opening
the menu) slides the scope label out and lingers ~1.2s after
leave/selection before collapsing. A non-empty scope tints the
icon primary. */}
{!embedded && (
<button
type="button"
onClick={() => setOpen(!open)}
aria-label={t("Select knowledge bases")}
aria-expanded={open}
{...lingerProps}
className={`inline-flex h-8 shrink-0 items-center rounded-lg px-2 text-[14px] font-medium transition-[background-color,color,transform] duration-150 active:scale-[0.97] ${
open
? "bg-[var(--muted)] text-[var(--foreground)]"
: count > 0
? "text-[var(--primary)] hover:bg-[var(--primary)]/[0.07]"
: "text-[var(--muted-foreground)] hover:bg-[var(--muted)]/55 hover:text-[var(--foreground)]"
}`}
>
<Database size={16} strokeWidth={1.7} className="shrink-0" />
<span
className={`flex min-w-0 items-center gap-1 overflow-hidden whitespace-nowrap transition-[max-width,opacity,margin-left] duration-300 ease-out ${
expanded
? "ml-1.5 max-w-[160px] opacity-100"
: "ml-0 max-w-0 opacity-0"
}`}
>
<span className="min-w-0 truncate">{label}</span>
<ChevronDown
size={13}
className={`shrink-0 transition-transform ${open ? "rotate-180" : ""}`}
/>
</span>
</button>
)}
{open && (
<div
className={
embedded
? "w-full"
: `dt-popup-up absolute right-0 z-50 ${menuPlacementClass} w-[min(280px,calc(100vw-32px))] overflow-hidden rounded-xl border border-[var(--border)] bg-[var(--popover)] shadow-lg backdrop-blur-md`
}
>
{embedded && knowledgeBases.length > 0 && (
<div className="border-b border-[var(--border)] px-3 py-2">
<input
aria-label={t("Search")}
placeholder={t("Search")}
value={query}
onChange={(e) => setQuery(e.target.value)}
className="w-full rounded-lg bg-[var(--muted)]/50 px-2 py-2 text-[13px] outline-none focus-visible:ring-1 focus-visible:ring-[var(--primary)]"
/>
</div>
)}
{knowledgeBases.length === 0 ? (
<div className="px-3 py-6 text-center text-[12px] text-[var(--muted-foreground)]">
<p>{t("No knowledge bases available")}</p>
<Link
href="/knowledge-bases"
className="mt-2 inline-flex items-center text-xs text-[var(--primary)] hover:underline"
>
{t("Create your first knowledge base")}
</Link>
</div>
) : (
<div className="max-h-[280px] overflow-y-auto py-1">
{knowledgeBases
.filter((kb) =>
kb.name.toLowerCase().includes(query.toLowerCase().trim()),
)
.map((kb) => {
const active = selected.includes(knowledgeBaseRef(kb));
return (
<button
key={knowledgeBaseRef(kb)}
type="button"
aria-pressed={active}
onClick={() => onToggle(knowledgeBaseRef(kb))}
className={`flex w-full items-center gap-2.5 px-3 py-2.5 text-left transition-colors active:bg-[var(--muted)]/70 ${
active
? "bg-[var(--primary)]/[0.06]"
: "hover:bg-[var(--muted)]/45"
}`}
>
<Database
size={15}
strokeWidth={1.7}
className={`shrink-0 ${
active
? "text-[var(--primary)]"
: "text-[var(--muted-foreground)]"
}`}
/>
<span className="min-w-0 flex-1 truncate text-[12.5px] font-medium text-[var(--foreground)]">
{kb.name}
{kb.provenance_label && (
<span className="ml-2 opacity-60">
{kb.provenance_label}
</span>
)}
</span>
{active && (
<Check
size={14}
strokeWidth={2}
className="shrink-0 text-[var(--primary)]"
/>
)}
</button>
);
})}
</div>
)}
</div>
)}
</div>
);
}