nlm-memory 0.4.0

package/src/ui/pages/settings/Index.tsx

@@ -0,0 +1,65 @@
+import { Link } from "react-router-dom";
+import { SettingsSubnav } from "./SettingsSubnav.js";
+import { useDataset } from "../../lib/dataset.js";
+
+interface Card {
+  to: string;
+  title: string;
+  body: (info: { sessions: number; entities: number; classifierProvider: string | null }) => string;
+}
+
+const CARDS: Card[] = [
+  {
+    to: "/settings/sources",
+    title: "Sources",
+    body: () => "Transcript origins the daemon scans. Add Claude Code, Hermes, pi.dev, custom JSONL directories, or webhook ingest.",
+  },
+  {
+    to: "/settings/providers",
+    title: "Providers",
+    body: () => "LLM endpoints (DeepSeek, Ollama, OpenAI, Anthropic, OpenRouter, custom). Manage keys and test connections.",
+  },
+  {
+    to: "/settings/labels",
+    title: "Labels",
+    body: ({ entities }) => `${entities} entities catalogued. Promote candidates and edit types.`,
+  },
+  {
+    to: "/settings/classifier",
+    title: "Classifier",
+    body: ({ classifierProvider }) =>
+      classifierProvider ? `Active provider: ${classifierProvider}.` : "Classifier provider unknown.",
+  },
+  {
+    to: "/settings/data",
+    title: "Data",
+    body: ({ sessions }) => `${sessions} sessions in the canonical store. Inspect path and backup posture.`,
+  },
+  {
+    to: "/settings/views",
+    title: "Views",
+    body: () => "Default landing page, density, sort, density tier.",
+  },
+];
+
+export function SettingsIndexPage() {
+  const { data } = useDataset();
+  const info = {
+    sessions: data?.meta.sessions_total ?? 0,
+    entities: data?.meta.entities_total ?? 0,
+    classifierProvider: null,
+  };
+  return (
+    <div className="page-pad">
+      <SettingsSubnav />
+      <div className="settings-grid">
+        {CARDS.map((c) => (
+          <Link key={c.to} to={c.to} className="card card-lift settings-card">
+            <h3 className="settings-card-title">{c.title}</h3>
+            <p className="settings-card-body">{c.body(info)}</p>
+          </Link>
+        ))}
+      </div>
+    </div>
+  );
+}

package/src/ui/pages/settings/Labels.tsx

@@ -0,0 +1,224 @@
+import { useEffect, useMemo, useState } from "react";
+import { SettingsSubnav } from "./SettingsSubnav.js";
+import { useDataset } from "../../lib/dataset.js";
+import { postAction } from "../../lib/actions.js";
+import { TableRowSkeleton } from "../../components/Skeleton.js";
+
+const LABEL_OPTIONS = ["candidate", "project", "tool", "contact", "service", "concept"];
+const STATUS_OPTIONS = ["all", "active", "snoozed", "retired"] as const;
+const SORT_OPTIONS = [
+  { value: "sessions-desc", label: "Sessions (high → low)" },
+  { value: "sessions-asc", label: "Sessions (low → high)" },
+  { value: "name-asc", label: "Name (A → Z)" },
+  { value: "name-desc", label: "Name (Z → A)" },
+  { value: "recent", label: "Most recently seen" },
+  { value: "oldest", label: "Least recently seen" },
+] as const;
+const PAGE_SIZE_OPTIONS = [25, 50, 100, 200] as const;
+
+type StatusFilter = (typeof STATUS_OPTIONS)[number];
+type SortKey = (typeof SORT_OPTIONS)[number]["value"];
+
+export function SettingsLabelsPage() {
+  const { data, loading, error, refetch } = useDataset();
+  const [search, setSearch] = useState("");
+  const [type, setType] = useState<string>("all");
+  const [status, setStatus] = useState<StatusFilter>("all");
+  const [sort, setSort] = useState<SortKey>("sessions-desc");
+  const [pageSize, setPageSize] = useState<number>(50);
+  const [page, setPage] = useState(0);
+  const [busyEntity, setBusyEntity] = useState<string | null>(null);
+
+  const entities = data?.entities ?? [];
+
+  const typeOptions = useMemo(() => {
+    const seen = new Set<string>(LABEL_OPTIONS);
+    for (const e of entities) seen.add(e.type);
+    return ["all", ...[...seen].sort()];
+  }, [entities]);
+
+  const filtered = useMemo(() => {
+    const q = search.toLowerCase().trim();
+    const list = entities.filter((e) => {
+      if (type !== "all" && e.type !== type) return false;
+      if (status !== "all" && e.status !== status) return false;
+      if (!q) return true;
+      return e.canonical.toLowerCase().includes(q) || e.type.toLowerCase().includes(q);
+    });
+    const sorted = [...list];
+    sorted.sort((a, b) => {
+      switch (sort) {
+        case "sessions-desc": return b.session_count - a.session_count;
+        case "sessions-asc": return a.session_count - b.session_count;
+        case "name-asc": return a.canonical.localeCompare(b.canonical);
+        case "name-desc": return b.canonical.localeCompare(a.canonical);
+        case "recent": return (b.last_seen_session ?? "").localeCompare(a.last_seen_session ?? "");
+        case "oldest": return (a.last_seen_session ?? "").localeCompare(b.last_seen_session ?? "");
+      }
+    });
+    return sorted;
+  }, [entities, search, type, status, sort]);
+
+  useEffect(() => { setPage(0); }, [search, type, status, sort, pageSize]);
+
+  const pageCount = Math.max(1, Math.ceil(filtered.length / pageSize));
+  const currentPage = Math.min(page, pageCount - 1);
+  const start = currentPage * pageSize;
+  const slice = filtered.slice(start, start + pageSize);
+
+  const mutate = async (entity: string, fn: () => Promise<void>) => {
+    setBusyEntity(entity);
+    try {
+      await fn();
+      await refetch();
+    } finally {
+      setBusyEntity(null);
+    }
+  };
+
+  const relabel = (entity: string, newType: string) =>
+    mutate(entity, () =>
+      postAction({ kind: "label_entity", subject_type: "entity", subject_id: entity, payload: { new_type: newType } }).then(() => {}),
+    );
+
+  const retire = (entity: string) =>
+    mutate(entity, () =>
+      postAction({ kind: "retire_entity", subject_type: "entity", subject_id: entity }).then(() => {}),
+    );
+
+  const snooze = (entity: string) => {
+    const until = new Date(Date.now() + 30 * 86_400_000).toISOString();
+    return mutate(entity, () =>
+      postAction({ kind: "snooze", subject_type: "entity", subject_id: entity, payload: { snoozed_until: until } }).then(() => {}),
+    );
+  };
+
+  return (
+    <div className="page-pad">
+      <SettingsSubnav />
+      <div className="page-header">
+        <h2 className="page-title">Labels</h2>
+        <input
+          className="search-input"
+          placeholder="search canonical or type…"
+          value={search}
+          onChange={(e) => setSearch(e.target.value)}
+        />
+      </div>
+
+      <div className="thread-filters">
+        <div className="filter-group" role="group" aria-label="Status filter">
+          {STATUS_OPTIONS.map((s) => (
+            <button
+              key={s}
+              type="button"
+              className={`chip${status === s ? " active" : ""}`}
+              onClick={() => setStatus(s)}
+            >{s}</button>
+          ))}
+        </div>
+        <div className="filter-group" role="group" aria-label="Type filter">
+          <label className="form-label">Type</label>
+          <select
+            className="form-input form-input-inline"
+            value={type}
+            onChange={(e) => setType(e.target.value)}
+          >
+            {typeOptions.map((t) => <option key={t} value={t}>{t}</option>)}
+          </select>
+        </div>
+        <div className="filter-group" role="group" aria-label="Sort">
+          <label className="form-label">Sort</label>
+          <select
+            className="form-input form-input-inline"
+            value={sort}
+            onChange={(e) => setSort(e.target.value as SortKey)}
+          >
+            {SORT_OPTIONS.map((o) => <option key={o.value} value={o.value}>{o.label}</option>)}
+          </select>
+        </div>
+        <span className="header-spacer" />
+        <span className="muted small">{filtered.length} match{filtered.length === 1 ? "" : "es"}</span>
+      </div>
+
+      {error && <div className="muted error">{error}</div>}
+      <table className="data-table">
+        <thead>
+          <tr>
+            <th>Canonical</th>
+            <th>Type</th>
+            <th>Status</th>
+            <th className="right">Sessions</th>
+            <th>Last seen</th>
+            <th>Actions</th>
+          </tr>
+        </thead>
+        {loading && !data && <TableRowSkeleton rows={8} cols={6} />}
+        <tbody>
+          {slice.map((e) => {
+            const busy = busyEntity === e.canonical;
+            return (
+              <tr key={e.canonical} className={busy ? "row-busy" : ""}>
+                <td className="canonical">
+                  <span className="dot" style={{ background: data?.entity_colors[e.canonical] ?? "#666" }} />
+                  {e.canonical}
+                </td>
+                <td>
+                  <select
+                    className="form-input form-input-inline"
+                    value={LABEL_OPTIONS.includes(e.type) ? e.type : "candidate"}
+                    onChange={(ev) => void relabel(e.canonical, ev.target.value)}
+                    disabled={busy}
+                  >
+                    {LABEL_OPTIONS.map((opt) => (
+                      <option key={opt} value={opt}>{opt}</option>
+                    ))}
+                  </select>
+                </td>
+                <td><span className={`chip-inline status-${e.status}`}>{e.status}</span></td>
+                <td className="right mono">{e.session_count}</td>
+                <td className="mono small">{e.last_seen_session ?? "—"}</td>
+                <td className="row-actions">
+                  <button type="button" className="chip" disabled={busy} onClick={() => void snooze(e.canonical)}>snooze 30d</button>
+                  <button type="button" className="chip" disabled={busy} onClick={() => void retire(e.canonical)}>retire</button>
+                </td>
+              </tr>
+            );
+          })}
+          {slice.length === 0 && (
+            <tr><td colSpan={6} className="muted small empty-row">
+              {entities.length === 0 ? "No entities yet." : "No entities match the current filters."}
+            </td></tr>
+          )}
+        </tbody>
+      </table>
+
+      {filtered.length > 0 && (
+        <div className="pagination">
+          <div className="page-size">
+            <label className="form-label">Per page</label>
+            <select
+              className="form-input form-input-inline"
+              value={pageSize}
+              onChange={(e) => setPageSize(Number.parseInt(e.target.value, 10))}
+            >
+              {PAGE_SIZE_OPTIONS.map((n) => <option key={n} value={n}>{n}</option>)}
+            </select>
+          </div>
+          <span className="header-spacer" />
+          <span className="muted small">
+            {start + 1}–{Math.min(start + pageSize, filtered.length)} of {filtered.length}
+          </span>
+          <div className="page-nav">
+            <button type="button" className="chip" disabled={currentPage === 0} onClick={() => setPage(0)}>« first</button>
+            <button type="button" className="chip" disabled={currentPage === 0} onClick={() => setPage((p) => Math.max(0, p - 1))}>‹ prev</button>
+            <span className="page-indicator mono">{currentPage + 1} / {pageCount}</span>
+            <button type="button" className="chip" disabled={currentPage >= pageCount - 1} onClick={() => setPage((p) => Math.min(pageCount - 1, p + 1))}>next ›</button>
+            <button type="button" className="chip" disabled={currentPage >= pageCount - 1} onClick={() => setPage(pageCount - 1)}>last »</button>
+          </div>
+        </div>
+      )}
+      <p className="muted small">Changes are append-only actions; refresh re-applies the overlay over the persisted store.</p>
+    </div>
+  );
+}

package/src/ui/pages/settings/Providers.tsx

@@ -0,0 +1,305 @@
+import { useCallback, useEffect, useState } from "react";
+import { SettingsSubnav } from "./SettingsSubnav.js";
+import {
+  fetchProviders,
+  testProvider,
+  PROVIDER_KINDS,
+  PROVIDER_KIND_LABEL,
+  PROVIDER_PRESETS,
+  type ProviderKind,
+  type ProviderRow,
+  type TestResult,
+} from "../../lib/registries.js";
+
+export function SettingsProvidersPage() {
+  const [providers, setProviders] = useState<ProviderRow[]>([]);
+  const [error, setError] = useState<string | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [showWizard, setShowWizard] = useState(false);
+  const [testStates, setTestStates] = useState<Record<number, TestResult | "running">>({});
+
+  const load = useCallback(async () => {
+    setLoading(true);
+    try {
+      setProviders(await fetchProviders());
+      setError(null);
+    } catch (e) {
+      setError(e instanceof Error ? e.message : String(e));
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => { void load(); }, [load]);
+
+  const toggleEnabled = async (row: ProviderRow) => {
+    await fetch(`/api/providers/${row.id}`, {
+      method: "PATCH",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ enabled: !row.enabled }),
+    });
+    await load();
+  };
+
+  const remove = async (row: ProviderRow) => {
+    if (!confirm(`Delete provider "${row.name}"? The Classifier will fall back to another provider if this one was active.`)) return;
+    await fetch(`/api/providers/${row.id}`, { method: "DELETE" });
+    await load();
+  };
+
+  const runTest = async (row: ProviderRow) => {
+    setTestStates((s) => ({ ...s, [row.id]: "running" }));
+    try {
+      const r = await testProvider(row.id);
+      setTestStates((s) => ({ ...s, [row.id]: r }));
+    } catch (e) {
+      setTestStates((s) => ({
+        ...s,
+        [row.id]: { ok: false, latencyMs: 0, error: e instanceof Error ? e.message : String(e) },
+      }));
+    }
+  };
+
+  return (
+    <div className="page-pad">
+      <SettingsSubnav />
+      <div className="form-row" style={{ justifyContent: "space-between" }}>
+        <h2 className="page-title" style={{ margin: 0 }}>Providers</h2>
+        <button type="button" className="btn btn-accent" onClick={() => setShowWizard(true)}>
+          Add provider
+        </button>
+      </div>
+
+      {loading && providers.length === 0 && <div className="muted">Loading…</div>}
+      {error && <div className="muted error">{error}</div>}
+
+      {providers.length > 0 && (
+        <table className="data-table">
+          <thead>
+            <tr>
+              <th>Name</th>
+              <th>Kind</th>
+              <th>Base URL</th>
+              <th>Default model</th>
+              <th>API key</th>
+              <th>Status</th>
+              <th>Last test</th>
+              <th></th>
+            </tr>
+          </thead>
+          <tbody>
+            {providers.map((p) => {
+              const t = testStates[p.id];
+              return (
+                <tr key={p.id}>
+                  <td className="mono">{p.name}</td>
+                  <td>{PROVIDER_KIND_LABEL[p.kind]}</td>
+                  <td className="mono small">{p.baseUrl ?? "—"}</td>
+                  <td className="mono small">{p.defaultModel ?? "—"}</td>
+                  <td>
+                    {p.kind === "ollama" || p.kind === "openai-compatible" ? (
+                      <span className="muted small">{p.hasApiKey ? "set" : "n/a"}</span>
+                    ) : (
+                      <span className={`chip-inline ${p.hasApiKey ? "status-active" : "status-stale"}`}>
+                        {p.hasApiKey ? "set" : "missing"}
+                      </span>
+                    )}
+                  </td>
+                  <td>
+                    <span className={`chip-inline ${p.enabled ? "status-active" : "status-stale"}`}>
+                      {p.enabled ? "enabled" : "disabled"}
+                    </span>
+                  </td>
+                  <td className="small">
+                    {t === "running" && <span className="muted">testing…</span>}
+                    {t && t !== "running" && t.ok && (
+                      <span className="muted">OK · {t.modelCount} models · {t.latencyMs}ms</span>
+                    )}
+                    {t && t !== "running" && !t.ok && (
+                      <span className="muted error">fail: {t.error}</span>
+                    )}
+                  </td>
+                  <td>
+                    <div className="form-row" style={{ gap: "0.5rem" }}>
+                      <button type="button" className="btn small" onClick={() => void runTest(p)}>
+                        Test
+                      </button>
+                      <button type="button" className="btn small" onClick={() => void toggleEnabled(p)}>
+                        {p.enabled ? "Disable" : "Enable"}
+                      </button>
+                      <button type="button" className="btn small" onClick={() => void remove(p)}>
+                        Delete
+                      </button>
+                    </div>
+                  </td>
+                </tr>
+              );
+            })}
+          </tbody>
+        </table>
+      )}
+
+      {!loading && providers.length === 0 && (
+        <p className="muted small">No providers yet. Click "Add provider" to wire up DeepSeek, Ollama, or any OpenAI-compatible endpoint.</p>
+      )}
+
+      {showWizard && (
+        <AddProviderWizard
+          onClose={() => setShowWizard(false)}
+          onCreated={() => {
+            setShowWizard(false);
+            void load();
+          }}
+        />
+      )}
+    </div>
+  );
+}
+
+function AddProviderWizard({
+  onClose,
+  onCreated,
+}: {
+  onClose: () => void;
+  onCreated: () => void;
+}) {
+  const [kind, setKind] = useState<ProviderKind>("deepseek");
+  const preset = PROVIDER_PRESETS[kind];
+  const [name, setName] = useState<string>(PROVIDER_KIND_LABEL[kind]);
+  const [baseUrl, setBaseUrl] = useState<string>(preset.baseUrl ?? "");
+  const [apiKey, setApiKey] = useState<string>("");
+  const [defaultModel, setDefaultModel] = useState<string>(preset.defaultModel ?? "");
+  const [busy, setBusy] = useState(false);
+  const [err, setErr] = useState<string | null>(null);
+  const [testInline, setTestInline] = useState<TestResult | null>(null);
+
+  useEffect(() => {
+    const p = PROVIDER_PRESETS[kind];
+    setName(PROVIDER_KIND_LABEL[kind]);
+    setBaseUrl(p.baseUrl ?? "");
+    setDefaultModel(p.defaultModel ?? "");
+    setTestInline(null);
+    setErr(null);
+  }, [kind]);
+
+  const keyRequired = kind !== "ollama" && kind !== "openai-compatible";
+
+  const submit = async (testAfter: boolean) => {
+    setBusy(true);
+    setErr(null);
+    try {
+      const body: Record<string, unknown> = { kind, name };
+      if (baseUrl) body["baseUrl"] = baseUrl;
+      if (apiKey) body["apiKey"] = apiKey;
+      if (defaultModel) body["defaultModel"] = defaultModel;
+      const r = await fetch("/api/providers", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(body),
+      });
+      const data = (await r.json()) as ProviderRow & { error?: string };
+      if (!r.ok || data.error) {
+        setErr(data.error ?? r.statusText);
+        return;
+      }
+      if (testAfter) {
+        const t = await testProvider(data.id);
+        setTestInline(t);
+        if (!t.ok) {
+          // Created but test failed — let user decide whether to keep it.
+          return;
+        }
+      }
+      onCreated();
+    } catch (e) {
+      setErr(e instanceof Error ? e.message : String(e));
+    } finally {
+      setBusy(false);
+    }
+  };
+
+  const canSubmit = !busy && name.length > 0 && (!keyRequired || apiKey.length > 0);
+
+  return (
+    <div className="card" style={{ padding: "1rem", marginTop: "1rem" }}>
+      <h3 className="section-title" style={{ marginTop: 0 }}>Add provider</h3>
+
+      <div className="form-row">
+        <label className="form-label">Kind</label>
+        <select
+          className="form-input form-input-inline"
+          value={kind}
+          onChange={(e) => setKind(e.target.value as ProviderKind)}
+          disabled={busy}
+        >
+          {PROVIDER_KINDS.map((k) => (
+            <option key={k} value={k}>{PROVIDER_KIND_LABEL[k]}</option>
+          ))}
+        </select>
+        <label className="form-label">Name</label>
+        <input
+          className="form-input form-input-inline"
+          value={name}
+          onChange={(e) => setName(e.target.value)}
+          placeholder="Display name (must be unique)"
+          disabled={busy}
+        />
+      </div>
+
+      <div className="form-row">
+        <label className="form-label">Base URL</label>
+        <input
+          className="form-input form-input-inline"
+          style={{ minWidth: "28rem" }}
+          value={baseUrl}
+          onChange={(e) => setBaseUrl(e.target.value)}
+          placeholder={kind === "openai-compatible" ? "https://your-endpoint/v1" : ""}
+          disabled={busy}
+        />
+      </div>
+
+      <div className="form-row">
+        <label className="form-label">API key{keyRequired ? "" : " (optional)"}</label>
+        <input
+          type="password"
+          className="form-input form-input-inline"
+          style={{ minWidth: "28rem" }}
+          value={apiKey}
+          onChange={(e) => setApiKey(e.target.value)}
+          autoComplete="off"
+          disabled={busy}
+        />
+      </div>
+
+      <div className="form-row">
+        <label className="form-label">Default model</label>
+        <input
+          className="form-input form-input-inline"
+          value={defaultModel}
+          onChange={(e) => setDefaultModel(e.target.value)}
+          placeholder="optional"
+          disabled={busy}
+        />
+      </div>
+
+      {testInline && !testInline.ok && (
+        <p className="muted error small">
+          Saved, but test failed: {testInline.error} ({testInline.latencyMs}ms). You can edit or delete from the list.
+        </p>
+      )}
+      {err && <p className="muted error small">{err}</p>}
+
+      <div className="form-row">
+        <button type="button" className="btn btn-accent" onClick={() => void submit(true)} disabled={!canSubmit}>
+          {busy ? "Saving…" : "Save & test"}
+        </button>
+        <button type="button" className="btn" onClick={() => void submit(false)} disabled={!canSubmit}>
+          Save without testing
+        </button>
+        <button type="button" className="btn" onClick={onClose} disabled={busy}>
+          Cancel
+        </button>
+      </div>
+    </div>
+  );
+}

package/src/ui/pages/settings/SettingsSubnav.tsx

@@ -0,0 +1,28 @@
+import { NavLink } from "react-router-dom";
+
+const ITEMS = [
+  { to: "/settings",            label: "Overview" },
+  { to: "/settings/sources",    label: "Sources" },
+  { to: "/settings/providers",  label: "Providers" },
+  { to: "/settings/classifier", label: "Classifier" },
+  { to: "/settings/labels",     label: "Labels" },
+  { to: "/settings/data",       label: "Data" },
+  { to: "/settings/views",      label: "Views" },
+];
+
+export function SettingsSubnav() {
+  return (
+    <div className="subnav">
+      {ITEMS.map((item) => (
+        <NavLink
+          key={item.to}
+          to={item.to}
+          end={item.to === "/settings"}
+          className={({ isActive }) => `subnav-link${isActive ? " active" : ""}`}
+        >
+          {item.label}
+        </NavLink>
+      ))}
+    </div>
+  );
+}