Skip to content

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

12.3 KB
Raw Blame
"use client";

import { useCallback, useEffect, useRef, useState } from "react";
import { Loader2 } from "lucide-react";
import { useTranslation } from "react-i18next";

import { apiFetch, apiUrl } from "@/lib/api";
import { EXTENSION_ENDPOINTS } from "@/lib/settings-extensions";
import {
  SettingRow,
  SettingSection,
  SettingsPageHeader,
} from "@/components/settings/shared";
import { useSettings } from "@/features/settings/store/SettingsStore";

interface MemorySettingsDTO {
  update: { l2_budget: number; l3_budget: number };
  audit: { l2_budget: number; l3_budget: number };
  dedup: { iterations: number; auto_after_update: boolean };
  merge: {
    auto_after_update: boolean;
    auto_after_audit: boolean;
    auto_after_dedup: boolean;
  };
  chunking: {
    overlap_ratio: number;
    boundary: "paragraph" | "sentence";
    min_chunk_chars: number;
    max_chunk_chars: number;
  };
  reference: {
    enforce_required: boolean;
    drop_invalid_refs: boolean;
  };
}

export default function MemorySettingsPage() {
  const { t } = useTranslation();
  const { registerExtension, pendingExtensionPayload, draftRevision } =
    useSettings();
  const [error, setError] = useState<string | null>(null);
  const [settings, setSettings] = useState<MemorySettingsDTO | null>(null);
  const [serverSnapshot, setServerSnapshot] =
    useState<MemorySettingsDTO | null>(null);

  useEffect(() => {
    let cancelled = false;
    void apiFetch(apiUrl(EXTENSION_ENDPOINTS.memory))
      .then((res) => {
        if (!res.ok) throw new Error(`HTTP ${res.status}`);
        return res.json() as Promise<MemorySettingsDTO>;
      })
      .then((data) => {
        if (cancelled) return;
        // A pending edit outlives the page it was made on; the server value is
        // the baseline dirtiness is measured against either way.
        const pending = pendingExtensionPayload("memory") as
          MemorySettingsDTO | undefined;
        setSettings(pending ?? data);
        setServerSnapshot(data);
        setError(null);
      })
      .catch((err) => {
        if (!cancelled)
          setError(err instanceof Error ? err.message : String(err));
      });
    return () => {
      cancelled = true;
    };
  }, [draftRevision, pendingExtensionPayload]);

  const dirty =
    !!settings &&
    !!serverSnapshot &&
    JSON.stringify(settings) !== JSON.stringify(serverSnapshot);

  // Latest-save ref so the closure handed to registerExtension always
  // reflects the current settings without re-registering on each render.
  const settingsRef = useRef<MemorySettingsDTO | null>(null);
  useEffect(() => {
    settingsRef.current = settings;
  }, [settings]);
  const save = useCallback(async () => {
    const current = settingsRef.current;
    if (!current) return;
    const res = await apiFetch(apiUrl(EXTENSION_ENDPOINTS.memory), {
      method: "PUT",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify(current),
    });
    if (!res.ok) throw new Error(`HTTP ${res.status}`);
    const data = (await res.json()) as MemorySettingsDTO;
    setSettings(data);
    setServerSnapshot(data);
  }, []);

  useEffect(() => {
    registerExtension("memory", { dirty, save, payload: settings });
    return () => registerExtension("memory", null);
  }, [dirty, save, settings, registerExtension]);

  function patch<K extends keyof MemorySettingsDTO>(
    key: K,
    value: Partial<MemorySettingsDTO[K]>,
  ) {
    if (!settings) return;
    setSettings({ ...settings, [key]: { ...settings[key], ...value } });
  }

  if (error)
    return (
      <p role="alert" className="text-sm text-red-600 dark:text-red-400">
        {t("Failed to load settings.")} {error}
      </p>
    );

  if (!settings) {
    return (
      <div className="grid h-[60vh] place-items-center text-[13px] text-[var(--muted-foreground)]">
        <Loader2 className="h-4 w-4 animate-spin" />
      </div>
    );
  }

  return (
    <div data-tour="tour-memory">
      <SettingsPageHeader
        title={t("Memory")}
        description={t(
          "Tune the chunk-based consolidator: how many LLM rounds per Update / Audit / Dedup, how aggressively to chunk, and how strictly to validate references.",
        )}
      />
      <SettingSection
        title={t("Update mode")}
        description={t(
          "Default LLM rounds for chunk-based incremental fact extraction. Per-doc overrides live in the workbench.",
        )}
      >
        <NumberRow
          label={t("L2 budget (per surface)")}
          help={t("Maximum chunks the chunker emits for an L2 update.")}
          value={settings.update.l2_budget}
          onChange={(n) => patch("update", { l2_budget: n })}
          min={1}
          max={200}
        />
        <NumberRow
          label={t("L3 budget (per slot)")}
          help={t("Maximum chunks for an L3 update across the 7 L2 docs.")}
          value={settings.update.l3_budget}
          onChange={(n) => patch("update", { l3_budget: n })}
          min={1}
          max={200}
        />
      </SettingSection>

      <SettingSection
        title={t("Audit mode")}
        description={t(
          "Default LLM rounds for line-level edits against raw evidence.",
        )}
      >
        <NumberRow
          label={t("L2 budget (per surface)")}
          value={settings.audit.l2_budget}
          onChange={(n) => patch("audit", { l2_budget: n })}
          min={1}
          max={200}
        />
        <NumberRow
          label={t("L3 budget (per slot)")}
          value={settings.audit.l3_budget}
          onChange={(n) => patch("audit", { l3_budget: n })}
          min={1}
          max={200}
        />
      </SettingSection>

      <SettingSection
        title={t("Dedup")}
        description={t(
          "Iterative dedup over the full doc. Stops early when an iteration emits zero edits.",
        )}
      >
        <NumberRow
          label={t("Iterations")}
          value={settings.dedup.iterations}
          onChange={(n) => patch("dedup", { iterations: n })}
          min={1}
          max={20}
        />
        <ToggleRow
          label={t("Run dedup automatically after Update")}
          value={settings.dedup.auto_after_update}
          onChange={(v) => patch("dedup", { auto_after_update: v })}
        />
      </SettingSection>

      <SettingSection
        title={t("Merge footnotes")}
        description={t(
          "No-LLM consolidation: collapse duplicate ref rows into one footnote each, then renumber. Idempotent, safe to run any time.",
        )}
      >
        <ToggleRow
          label={t("Merge automatically after Update")}
          value={settings.merge.auto_after_update}
          onChange={(v) => patch("merge", { auto_after_update: v })}
        />
        <ToggleRow
          label={t("Merge automatically after Audit")}
          value={settings.merge.auto_after_audit}
          onChange={(v) => patch("merge", { auto_after_audit: v })}
        />
        <ToggleRow
          label={t("Merge automatically after Dedup")}
          value={settings.merge.auto_after_dedup}
          onChange={(v) => patch("merge", { auto_after_dedup: v })}
        />
      </SettingSection>

      <SettingSection
        title={t("Chunking")}
        description={t("Lower-level knobs that shape how content is split.")}
      >
        <NumberRow
          label={t("Overlap ratio")}
          help={t("Fraction of chunk size carried into the next chunk. 0–0.5.")}
          value={settings.chunking.overlap_ratio}
          onChange={(n) => patch("chunking", { overlap_ratio: n })}
          min={0}
          max={0.5}
          step={0.05}
          isFloat
        />
        <SelectRow
          label={t("Boundary")}
          help={t("Where the chunker prefers to cut.")}
          value={settings.chunking.boundary}
          options={[
            { value: "paragraph", label: t("Paragraph") },
            { value: "sentence", label: t("Sentence") },
          ]}
          onChange={(v) =>
            patch("chunking", { boundary: v as "paragraph" | "sentence" })
          }
        />
        <NumberRow
          label={t("Min chunk chars")}
          help={t("Floor for individual chunk size.")}
          value={settings.chunking.min_chunk_chars}
          onChange={(n) => patch("chunking", { min_chunk_chars: n })}
          min={200}
          max={64000}
          step={100}
        />
        <NumberRow
          label={t("Max chunk chars")}
          help={t("Ceiling for individual chunk size.")}
          value={settings.chunking.max_chunk_chars}
          onChange={(n) => patch("chunking", { max_chunk_chars: n })}
          min={200}
          max={64000}
          step={100}
        />
      </SettingSection>

      <SettingSection
        title={t("References")}
        description={t(
          "How strictly facts must cite the chunk they were extracted from.",
        )}
      >
        <ToggleRow
          label={t("Require ref on every fact")}
          help={t("Drops facts that come back without a ref.")}
          value={settings.reference.enforce_required}
          onChange={(v) => patch("reference", { enforce_required: v })}
        />
        <ToggleRow
          label={t("Drop invalid refs (vs reject the whole fact)")}
          help={t(
            "On: keep the fact, drop only out-of-pool refs. Off: any bad ref rejects the fact.",
          )}
          value={settings.reference.drop_invalid_refs}
          onChange={(v) => patch("reference", { drop_invalid_refs: v })}
        />
      </SettingSection>
    </div>
  );
}

// ── Field components ────────────────────────────────────────────────

interface NumberRowProps {
  label: string;
  help?: string;
  value: number;
  onChange: (n: number) => void;
  min?: number;
  max?: number;
  step?: number;
  isFloat?: boolean;
}

function NumberRow({
  label,
  help,
  value,
  onChange,
  min,
  max,
  step = 1,
  isFloat = false,
}: NumberRowProps) {
  return (
    <SettingRow
      title={label}
      description={help}
      control={
        <input
          type="number"
          value={value}
          min={min}
          max={max}
          step={step}
          onChange={(e) => {
            const raw = e.target.value;
            if (raw === "") return;
            const n = isFloat ? parseFloat(raw) : parseInt(raw, 10);
            if (!Number.isNaN(n)) onChange(n);
          }}
          className="w-24 rounded-md border border-[var(--border)] bg-[var(--background)] px-2 py-1 text-right text-[12px] outline-none focus:border-[var(--primary)]"
        />
      }
    />
  );
}

interface ToggleRowProps {
  label: string;
  help?: string;
  value: boolean;
  onChange: (v: boolean) => void;
}

function ToggleRow({ label, help, value, onChange }: ToggleRowProps) {
  return (
    <SettingRow
      title={label}
      description={help}
      control={
        <button
          type="button"
          role="switch"
          aria-checked={value}
          onClick={() => onChange(!value)}
          className={
            "relative inline-flex h-5 w-9 items-center rounded-full transition " +
            (value ? "bg-[var(--primary)]" : "bg-[var(--muted)]")
          }
        >
          <span
            className={
              "inline-block h-4 w-4 transform rounded-full bg-white shadow transition " +
              (value ? "translate-x-4" : "translate-x-0.5")
            }
          />
        </button>
      }
    />
  );
}

interface SelectRowProps {
  label: string;
  help?: string;
  value: string;
  options: { value: string; label: string }[];
  onChange: (v: string) => void;
}

function SelectRow({ label, help, value, options, onChange }: SelectRowProps) {
  return (
    <SettingRow
      title={label}
      description={help}
      control={
        <div className="flex gap-0.5 rounded-lg bg-[var(--muted)] p-0.5">
          {options.map((o) => (
            <button
              key={o.value}
              type="button"
              onClick={() => onChange(o.value)}
              className={
                "rounded-md px-2.5 py-1 text-[12px] transition-all " +
                (value === o.value
                  ? "bg-[var(--card)] font-medium text-[var(--foreground)] shadow-sm"
                  : "text-[var(--muted-foreground)] hover:text-[var(--foreground)]")
              }
            >
              {o.label}
            </button>
          ))}
        </div>
      }
    />
  );
}