ltcai 3.0.1 → 3.2.0

package/static/v3/js/views/mcp.js

@@ -0,0 +1,114 @@
+/* ============================================================================
+ * View: MCP Manager — connected MCP servers, available tools, health.
+ * Reads /mcp/tools, /mcp/installed, /mcp/claude-code-servers, /mcp/custom and
+ * lets the user inspect connected servers and recommend new ones. Unavailable
+ * state is explicit; nothing is invented.
+ * ========================================================================== */
+
+export async function render(ctx) {
+  const { h, c } = ctx;
+  const src = h("span", c.sourceBadge("pending"));
+  const statHost = h("div.lt3-statrow", c.loading({ lines: 1 }));
+  const serversHost = h("div", c.loading({ lines: 3, block: true }));
+  const recHost = h("div");
+  const recInput = h("input.lt3-input", { type: "text", placeholder: "Describe what you need (e.g. “web search”, “github”)…", "aria-label": "Recommend MCP" });
+
+  const root = h("div.lt3-stack-6",
+    c.viewHeader({
+      eyebrow: "Platform",
+      title: "MCP Manager",
+      sub: "Model Context Protocol servers: what is connected, the tools they expose, their permissions, and their health — managed from /app.",
+      actions: [src],
+    }),
+    statHost,
+    c.panel({
+      title: "Recommend a server", sub: "Find MCP servers that match a capability.",
+      children: h("div.lt3-stack-3",
+        h("div.lt3-row-2", recInput, h("button.lt3-btn.lt3-btn--primary", { on: { click: recommend } }, c.icon("search"), "Recommend")),
+        recHost),
+    }),
+    h("section", c.sectionHead("Connected servers"), serversHost),
+  );
+
+  load();
+  return root;
+
+  async function load() {
+    const [tools, claude, custom] = await Promise.all([ctx.api.mcpTools(), ctx.api.mcpClaudeServers(), ctx.api.mcpCustom()]);
+    src.replaceChildren(c.sourceBadge(tools.source));
+    const installed = (tools.data && tools.data.installed_mcps) || [];
+    const claudeServers = (claude.data && claude.data.servers) || [];
+    const customServers = (custom.data && custom.data.custom) || [];
+    const toolList = (tools.data && tools.data.tools) || [];
+    const servers = mergeServers(installed, claudeServers, customServers);
+
+    if (!servers.length && !toolList.length) {
+      statHost.replaceChildren(c.stat({ label: "MCP", value: "—", icon: "plug-connected" }));
+      serversHost.replaceChildren(c.emptyState({ icon: "plug-off", title: "MCP unavailable", body: "Start the backend to read MCP servers and tools." }));
+      return;
+    }
+    const connected = servers.filter((s) => s.installed).length;
+    statHost.replaceChildren(
+      c.stat({ label: "Servers", value: c.fmtNum(servers.length), icon: "server" }),
+      c.stat({ label: "Connected", value: c.fmtNum(connected), icon: "plug-connected" }),
+      c.stat({ label: "Local tools", value: c.fmtNum(toolList.length), icon: "tools" }),
+    );
+    if (!servers.length) {
+      serversHost.replaceChildren(c.emptyState({ icon: "plug", title: "No MCP servers", body: "No MCP servers are registered yet. Use Recommend to find some." }));
+      return;
+    }
+    serversHost.replaceChildren(h("div.lt3-grid-auto", servers.map((s) => serverCard(ctx, s))));
+  }
+
+  function serverCard(ctx2, s) {
+    return c.card(h("div.lt3-stack-3",
+      h("div.lt3-row", { style: { "justify-content": "space-between", "align-items": "flex-start" } },
+        h("div.lt3-row-2",
+          h("span.lt3-avatar", { style: { width: "34px", height: "34px", "border-radius": "var(--lt3-radius-md)" } }, s.icon && s.icon.length <= 2 ? s.icon : c.icon("plug")),
+          h("div", h("b", s.name), h("div.lt3-faint", { style: { "font-size": "var(--lt3-text-2xs)" } }, s.category || s.source || "")),
+        ),
+        c.statePill(s.installed ? "ready" : "available"),
+      ),
+      s.description ? h("p.lt3-muted", { style: { margin: 0, "font-size": "var(--lt3-text-sm)" } }, s.description) : null,
+      s.package ? h("div.lt3-faint", { style: { "font-size": "var(--lt3-text-2xs)", "font-family": "var(--lt3-font-mono)", "word-break": "break-all" } }, s.package) : null,
+      Array.isArray(s.env_vars) && s.env_vars.length ? h("div.lt3-cluster", s.env_vars.slice(0, 4).map((e) => h("span.lt3-chip", c.icon("key"), e.name || e))) : null,
+    ), { interactive: false });
+  }
+
+  async function recommend() {
+    const q = recInput.value.trim();
+    if (!q) { ctx.toast("Describe what you need", "info"); return; }
+    recHost.replaceChildren(c.loading({ lines: 2 }));
+    const res = await ctx.api.mcpRecommend(q, 6);
+    const recs = (res && res.data && (res.data.recommendations || res.data)) || [];
+    if (!res || !res.ok || !Array.isArray(recs) || !recs.length) {
+      recHost.replaceChildren(c.banner("No recommendations available — the MCP registry may be offline.", "info"));
+      return;
+    }
+    recHost.replaceChildren(h("div.lt3-stack-2", recs.slice(0, 6).map((r) => c.card(
+      h("div.lt3-row", { style: { "justify-content": "space-between" } },
+        h("div", h("b", r.name || r.id), h("p.lt3-muted", { style: { margin: 0, "font-size": "var(--lt3-text-sm)" } }, r.description || "")),
+        r.category ? c.pill(r.category) : null),
+      { flat: true }))));
+  }
+}
+
+function mergeServers(installed, claude, custom) {
+  const out = [];
+  const seen = new Set();
+  const push = (s, source) => {
+    const id = s.id || s.name;
+    if (!id || seen.has(id)) return;
+    seen.add(id);
+    out.push({
+      id, name: s.name || id, description: s.description || "", category: s.category || source,
+      package: s.package || "", icon: s.icon || "", source: s.source || source,
+      installed: s.installed != null ? !!s.installed : source === "claude-code",
+      env_vars: s.env_vars || [],
+    });
+  };
+  (installed || []).forEach((s) => push(s, "registry"));
+  (claude || []).forEach((s) => push(s, "claude-code"));
+  (custom || []).forEach((s) => push(s, "custom"));
+  return out;
+}

package/static/v3/js/views/memory.d2ed7a7c.js

@@ -0,0 +1,146 @@
+/* ============================================================================
+ * View: Memory — the long-term memory platform + Memory Manager.
+ * Reads /api/memory/manager (usage / sources / health / size / type) and offers
+ * recall, inspect, prune, compact, rebuild, and clear. Every number comes from a
+ * real store; tiers with no backing report unavailable.
+ * ========================================================================== */
+
+const TIER_ICON = {
+  workspace: "building-warehouse", project: "folders", agent: "robot",
+  conversation: "messages", graph: "chart-dots-3", vector: "grid-dots",
+};
+
+export async function render(ctx) {
+  const { h, c } = ctx;
+
+  const srcBadge = h("span", c.sourceBadge("pending"));
+  const statHost = h("div.lt3-statrow", c.loading({ lines: 1 }));
+  const sourcesHost = h("div", c.loading({ lines: 3, block: true }));
+  const recallHost = h("div");
+  const inspectHost = h("div", h("p.lt3-faint", { style: { margin: 0 } }, "Pick a tier to inspect its contents."));
+
+  const recallInput = h("input.lt3-input", { type: "text", placeholder: "Recall across every memory tier…", "aria-label": "Recall memory" });
+
+  const root = h("div.lt3-stack-6",
+    c.viewHeader({
+      eyebrow: "Retrieval",
+      title: "Memory",
+      sub: "Long-term memory unified across workspace, project, agent, conversation, graph, and vector tiers — recall, inspect, and maintain it without leaving /app.",
+      actions: [srcBadge],
+    }),
+    statHost,
+    c.panel({
+      title: "Recall", sub: "Unified retrieval across the memory tiers.",
+      children: h("div.lt3-stack-3",
+        h("div.lt3-row-2",
+          recallInput,
+          h("button.lt3-btn.lt3-btn--primary", { on: { click: doRecall } }, c.icon("search"), "Recall"),
+        ),
+        recallHost,
+      ),
+    }),
+    h("section",
+      c.sectionHead("Memory sources", h("div.lt3-row-2",
+        h("button.lt3-btn.lt3-btn--subtle.lt3-btn--sm", { on: { click: () => act("compact") } }, c.icon("arrows-minimize"), "Compact"),
+        h("button.lt3-btn.lt3-btn--subtle.lt3-btn--sm", { on: { click: () => act("rebuild") } }, c.icon("refresh"), "Rebuild vectors"),
+      )),
+      sourcesHost,
+    ),
+    c.panel({ title: "Inspect tier", children: h("div.lt3-stack-3", tierTabs(ctx, inspectHost), inspectHost) }),
+  );
+
+  hydrate();
+  return root;
+
+  async function hydrate() {
+    const res = await ctx.api.memoryManager();
+    const data = res.data || {};
+    const sources = Array.isArray(data.sources) ? data.sources : [];
+    srcBadge.replaceChildren(c.sourceBadge(res.source));
+
+    if (!sources.length) {
+      statHost.replaceChildren(c.stat({ label: "Memory", value: "—", icon: "brain" }));
+      sourcesHost.replaceChildren(c.emptyState({ icon: "database-off", title: "Memory unavailable", body: "Start the backend to read the memory platform." }));
+      return;
+    }
+    const usage = data.usage || {};
+    statHost.replaceChildren(
+      c.stat({ label: "Total items", value: c.fmtNum(usage.total_items), icon: "stack-2" }),
+      c.stat({ label: "On disk", value: fmtBytes(usage.total_bytes), icon: "database" }),
+      c.stat({ label: "Tiers", value: c.fmtNum((data.tiers || []).length), icon: "layers" }),
+      c.stat({ label: "Health", value: data.health || "—", icon: "heartbeat" }),
+    );
+    sourcesHost.replaceChildren(c.table(
+      [
+        { key: "label", label: "Source", render: (r) => h("div.lt3-row-2", c.icon(TIER_ICON[r.type] || "circle"), h("b", r.label)) },
+        { key: "type", label: "Type", width: "1%", render: (r) => c.pill(r.type) },
+        { key: "count", label: "Items", width: "1%", render: (r) => h("span", { style: { "font-variant-numeric": "tabular-nums" } }, r.count == null ? "—" : c.fmtNum(r.count)) },
+        { key: "size", label: "Size", width: "1%", render: (r) => h("span.lt3-faint", r.size_bytes ? fmtBytes(r.size_bytes) : "—") },
+        { key: "health", label: "Health", width: "1%", render: (r) => c.statePill(r.health === "ok" ? "ready" : r.health === "unavailable" ? "failed" : "idle") },
+        { key: "detail", label: "Detail", render: (r) => h("span.lt3-muted", r.detail || "") },
+      ],
+      sources,
+    ));
+  }
+
+  async function doRecall() {
+    const q = recallInput.value.trim();
+    recallHost.replaceChildren(c.loading({ lines: 2 }));
+    const res = await ctx.api.memoryRecall(q, 25);
+    const items = (res.data && res.data.results) || [];
+    if (!res.ok) { recallHost.replaceChildren(c.banner("Recall is unavailable — start the backend.", "warn")); return; }
+    if (!items.length) { recallHost.replaceChildren(c.emptyState({ icon: "search-off", title: "No matches", body: "Nothing recalled for that query yet." })); return; }
+    recallHost.replaceChildren(h("div.lt3-stack-2", items.map((it) => c.card(
+      h("div.lt3-stack-2",
+        h("div.lt3-row", { style: { "justify-content": "space-between" } }, h("b", it.title || "memory"), c.pill(it.source, it.source === "graph" ? "info" : "")),
+        h("p.lt3-muted", { style: { margin: 0, "font-size": "var(--lt3-text-sm)" } }, it.snippet || ""),
+      ), { flat: true },
+    ))));
+  }
+
+  async function act(kind) {
+    const fn = kind === "compact" ? ctx.api.memoryCompact() : ctx.api.memoryRebuild("vector");
+    const res = await fn;
+    if (res && (res.ok || res.data)) {
+      const d = res.data || res;
+      const msg = kind === "compact" ? `Compacted ${d.compacted ?? 0} duplicate memories` : `Rebuild: ${d.status || "ok"}`;
+      ctx.toast(msg, d.status === "error" || d.status === "unavailable" ? "err" : "ok");
+    } else {
+      ctx.toast(`${kind} unavailable`, "err");
+    }
+    hydrate();
+  }
+
+  function tierTabs(ctx2, host) {
+    const tiers = ["workspace", "project", "agent", "conversation", "graph", "vector"];
+    let active = null;
+    return c.segmented(tiers.map((t) => ({ key: t, label: t })), active, async (key) => {
+      host.replaceChildren(c.loading({ lines: 2 }));
+      const res = await ctx2.api.memoryInspect(key, 50);
+      const d = res.data || {};
+      if (key === "graph") { host.replaceChildren(jsonBlock(ctx2, d.stats || {}, d.available)); return; }
+      if (key === "vector") { host.replaceChildren(jsonBlock(ctx2, d.index || {}, d.available)); return; }
+      const items = d.items || [];
+      if (!items.length) { host.replaceChildren(c.emptyState({ icon: "inbox", title: `No ${key} memory`, body: "This tier has no items yet." })); return; }
+      host.replaceChildren(h("div.lt3-stack-2", items.slice(0, 50).map((m) => c.card(
+        h("div.lt3-stack-2",
+          h("div.lt3-row-2", m.kind ? c.pill(m.kind) : null, h("b", { style: { "font-size": "var(--lt3-text-sm)" } }, m.title || m.id || "item")),
+          h("p.lt3-muted", { style: { margin: 0, "font-size": "var(--lt3-text-sm)" } }, m.content || (m.messages != null ? `${m.messages} messages` : "")),
+        ), { flat: true },
+      ))));
+    });
+  }
+
+  function jsonBlock(ctx2, obj, available) {
+    if (!available) return c.emptyState({ icon: "database-off", title: "Unavailable", body: "This tier is disabled or empty." });
+    return h("pre", { style: { margin: 0, "white-space": "pre-wrap", "font-family": "var(--lt3-font-mono)", "font-size": "var(--lt3-text-xs)", color: "var(--muted)" } }, JSON.stringify(obj, null, 2));
+  }
+}
+
+function fmtBytes(n) {
+  const v = Number(n) || 0;
+  if (v <= 0) return "—";
+  if (v >= 1 << 20) return (v / (1 << 20)).toFixed(1) + " MB";
+  if (v >= 1 << 10) return (v / (1 << 10)).toFixed(1) + " KB";
+  return v + " B";
+}

package/static/v3/js/views/memory.js

@@ -0,0 +1,146 @@
+/* ============================================================================
+ * View: Memory — the long-term memory platform + Memory Manager.
+ * Reads /api/memory/manager (usage / sources / health / size / type) and offers
+ * recall, inspect, prune, compact, rebuild, and clear. Every number comes from a
+ * real store; tiers with no backing report unavailable.
+ * ========================================================================== */
+
+const TIER_ICON = {
+  workspace: "building-warehouse", project: "folders", agent: "robot",
+  conversation: "messages", graph: "chart-dots-3", vector: "grid-dots",
+};
+
+export async function render(ctx) {
+  const { h, c } = ctx;
+
+  const srcBadge = h("span", c.sourceBadge("pending"));
+  const statHost = h("div.lt3-statrow", c.loading({ lines: 1 }));
+  const sourcesHost = h("div", c.loading({ lines: 3, block: true }));
+  const recallHost = h("div");
+  const inspectHost = h("div", h("p.lt3-faint", { style: { margin: 0 } }, "Pick a tier to inspect its contents."));
+
+  const recallInput = h("input.lt3-input", { type: "text", placeholder: "Recall across every memory tier…", "aria-label": "Recall memory" });
+
+  const root = h("div.lt3-stack-6",
+    c.viewHeader({
+      eyebrow: "Retrieval",
+      title: "Memory",
+      sub: "Long-term memory unified across workspace, project, agent, conversation, graph, and vector tiers — recall, inspect, and maintain it without leaving /app.",
+      actions: [srcBadge],
+    }),
+    statHost,
+    c.panel({
+      title: "Recall", sub: "Unified retrieval across the memory tiers.",
+      children: h("div.lt3-stack-3",
+        h("div.lt3-row-2",
+          recallInput,
+          h("button.lt3-btn.lt3-btn--primary", { on: { click: doRecall } }, c.icon("search"), "Recall"),
+        ),
+        recallHost,
+      ),
+    }),
+    h("section",
+      c.sectionHead("Memory sources", h("div.lt3-row-2",
+        h("button.lt3-btn.lt3-btn--subtle.lt3-btn--sm", { on: { click: () => act("compact") } }, c.icon("arrows-minimize"), "Compact"),
+        h("button.lt3-btn.lt3-btn--subtle.lt3-btn--sm", { on: { click: () => act("rebuild") } }, c.icon("refresh"), "Rebuild vectors"),
+      )),
+      sourcesHost,
+    ),
+    c.panel({ title: "Inspect tier", children: h("div.lt3-stack-3", tierTabs(ctx, inspectHost), inspectHost) }),
+  );
+
+  hydrate();
+  return root;
+
+  async function hydrate() {
+    const res = await ctx.api.memoryManager();
+    const data = res.data || {};
+    const sources = Array.isArray(data.sources) ? data.sources : [];
+    srcBadge.replaceChildren(c.sourceBadge(res.source));
+
+    if (!sources.length) {
+      statHost.replaceChildren(c.stat({ label: "Memory", value: "—", icon: "brain" }));
+      sourcesHost.replaceChildren(c.emptyState({ icon: "database-off", title: "Memory unavailable", body: "Start the backend to read the memory platform." }));
+      return;
+    }
+    const usage = data.usage || {};
+    statHost.replaceChildren(
+      c.stat({ label: "Total items", value: c.fmtNum(usage.total_items), icon: "stack-2" }),
+      c.stat({ label: "On disk", value: fmtBytes(usage.total_bytes), icon: "database" }),
+      c.stat({ label: "Tiers", value: c.fmtNum((data.tiers || []).length), icon: "layers" }),
+      c.stat({ label: "Health", value: data.health || "—", icon: "heartbeat" }),
+    );
+    sourcesHost.replaceChildren(c.table(
+      [
+        { key: "label", label: "Source", render: (r) => h("div.lt3-row-2", c.icon(TIER_ICON[r.type] || "circle"), h("b", r.label)) },
+        { key: "type", label: "Type", width: "1%", render: (r) => c.pill(r.type) },
+        { key: "count", label: "Items", width: "1%", render: (r) => h("span", { style: { "font-variant-numeric": "tabular-nums" } }, r.count == null ? "—" : c.fmtNum(r.count)) },
+        { key: "size", label: "Size", width: "1%", render: (r) => h("span.lt3-faint", r.size_bytes ? fmtBytes(r.size_bytes) : "—") },
+        { key: "health", label: "Health", width: "1%", render: (r) => c.statePill(r.health === "ok" ? "ready" : r.health === "unavailable" ? "failed" : "idle") },
+        { key: "detail", label: "Detail", render: (r) => h("span.lt3-muted", r.detail || "") },
+      ],
+      sources,
+    ));
+  }
+
+  async function doRecall() {
+    const q = recallInput.value.trim();
+    recallHost.replaceChildren(c.loading({ lines: 2 }));
+    const res = await ctx.api.memoryRecall(q, 25);
+    const items = (res.data && res.data.results) || [];
+    if (!res.ok) { recallHost.replaceChildren(c.banner("Recall is unavailable — start the backend.", "warn")); return; }
+    if (!items.length) { recallHost.replaceChildren(c.emptyState({ icon: "search-off", title: "No matches", body: "Nothing recalled for that query yet." })); return; }
+    recallHost.replaceChildren(h("div.lt3-stack-2", items.map((it) => c.card(
+      h("div.lt3-stack-2",
+        h("div.lt3-row", { style: { "justify-content": "space-between" } }, h("b", it.title || "memory"), c.pill(it.source, it.source === "graph" ? "info" : "")),
+        h("p.lt3-muted", { style: { margin: 0, "font-size": "var(--lt3-text-sm)" } }, it.snippet || ""),
+      ), { flat: true },
+    ))));
+  }
+
+  async function act(kind) {
+    const fn = kind === "compact" ? ctx.api.memoryCompact() : ctx.api.memoryRebuild("vector");
+    const res = await fn;
+    if (res && (res.ok || res.data)) {
+      const d = res.data || res;
+      const msg = kind === "compact" ? `Compacted ${d.compacted ?? 0} duplicate memories` : `Rebuild: ${d.status || "ok"}`;
+      ctx.toast(msg, d.status === "error" || d.status === "unavailable" ? "err" : "ok");
+    } else {
+      ctx.toast(`${kind} unavailable`, "err");
+    }
+    hydrate();
+  }
+
+  function tierTabs(ctx2, host) {
+    const tiers = ["workspace", "project", "agent", "conversation", "graph", "vector"];
+    let active = null;
+    return c.segmented(tiers.map((t) => ({ key: t, label: t })), active, async (key) => {
+      host.replaceChildren(c.loading({ lines: 2 }));
+      const res = await ctx2.api.memoryInspect(key, 50);
+      const d = res.data || {};
+      if (key === "graph") { host.replaceChildren(jsonBlock(ctx2, d.stats || {}, d.available)); return; }
+      if (key === "vector") { host.replaceChildren(jsonBlock(ctx2, d.index || {}, d.available)); return; }
+      const items = d.items || [];
+      if (!items.length) { host.replaceChildren(c.emptyState({ icon: "inbox", title: `No ${key} memory`, body: "This tier has no items yet." })); return; }
+      host.replaceChildren(h("div.lt3-stack-2", items.slice(0, 50).map((m) => c.card(
+        h("div.lt3-stack-2",
+          h("div.lt3-row-2", m.kind ? c.pill(m.kind) : null, h("b", { style: { "font-size": "var(--lt3-text-sm)" } }, m.title || m.id || "item")),
+          h("p.lt3-muted", { style: { margin: 0, "font-size": "var(--lt3-text-sm)" } }, m.content || (m.messages != null ? `${m.messages} messages` : "")),
+        ), { flat: true },
+      ))));
+    });
+  }
+
+  function jsonBlock(ctx2, obj, available) {
+    if (!available) return c.emptyState({ icon: "database-off", title: "Unavailable", body: "This tier is disabled or empty." });
+    return h("pre", { style: { margin: 0, "white-space": "pre-wrap", "font-family": "var(--lt3-font-mono)", "font-size": "var(--lt3-text-xs)", color: "var(--muted)" } }, JSON.stringify(obj, null, 2));
+  }
+}
+
+function fmtBytes(n) {
+  const v = Number(n) || 0;
+  if (v <= 0) return "—";
+  if (v >= 1 << 20) return (v / (1 << 20)).toFixed(1) + " MB";
+  if (v >= 1 << 10) return (v / (1 << 10)).toFixed(1) + " KB";
+  return v + " B";
+}

package/static/v3/js/views/models.a1ffa147.js

@@ -0,0 +1,256 @@
+/* ============================================================================
+ * View: Models — the local MLX runtime.
+ * Lists the language models available to the runtime, highlights the loaded
+ * one, and shows the local embedding signal that backs the Vector Index.
+ * Shows the runtime as unavailable when the backend endpoint isn't available.
+ *
+ * View contract (shared by all views):
+ *   export async function render(ctx) -> single DOM node
+ *   ctx = { h, icon, api, store, c, route, params, navigate, toast }
+ * ========================================================================== */
+
+export async function render(ctx) {
+  const { h, icon, api, c } = ctx;
+
+  const srcSlot = h("span", c.sourceBadge("pending"));
+  const activeHost = h("div", c.loading({ lines: 2, block: true }));
+  const statHost = h("div.lt3-statrow", c.loading({ lines: 1 }));
+  const embedHost = h("div", c.loading({ lines: 2 }));
+  const tableHost = h("div", c.loading({ lines: 4 }));
+
+  const root = h("div.lt3-stack-6",
+    c.viewHeader({
+      eyebrow: "Compute",
+      title: "Models",
+      sub: "Local and OpenAI-compatible runtime choices. Local models keep generation on this machine; cloud-compatible providers are shown only when configured.",
+      actions: [
+        srcSlot,
+        h("button.lt3-btn.lt3-btn--ghost", { on: { click: () => load() } }, icon("refresh"), "Refresh"),
+      ],
+    }),
+    activeHost,
+    statHost,
+    c.panel({
+      eyebrow: "Retrieval",
+      title: "Embedding models",
+      sub: "Production semantic providers and the local hash fallback share the same vector-index contract.",
+      children: embedHost,
+    }),
+    c.panel({
+      head: h("div.lt3-row", { style: { "justify-content": "space-between", "align-items": "center", width: "100%" } },
+        h("div", h("div.lt3-eyebrow", "Runtime"), h("h3.lt3-panel__title", "Model catalog")),
+        h("span", { id: "models-cat-src" }, c.sourceBadge("pending")),
+      ),
+      children: tableHost,
+    }),
+  );
+
+  async function load() {
+    activeHost.replaceChildren(c.loading({ lines: 2, block: true }));
+    tableHost.replaceChildren(c.loading({ lines: 4 }));
+    embedHost.replaceChildren(c.loading({ lines: 2 }));
+
+    const [res, emb] = await Promise.all([api.models(), api.embeddingsStatus()]);
+    const data = res.data || {};
+    const catalog = Array.isArray(data.catalog) ? data.catalog : [];
+
+    srcSlot.replaceChildren(c.sourceBadge(res.source));
+    root.querySelector("#models-cat-src")?.replaceChildren(c.sourceBadge(res.source));
+
+    if (!catalog.length) {
+      activeHost.replaceChildren(
+        c.emptyState({ icon: "cpu-off", title: "No models available", body: "Start or configure a local/OpenAI-compatible runtime to list models here." }),
+      );
+      statHost.replaceChildren();
+      renderEmbeddings([], emb);
+      tableHost.replaceChildren(c.emptyState({ icon: "cpu-off", title: "Catalog is empty", body: "Connect a model runtime to list installed and recommended models." }));
+      return;
+    }
+
+    const isEmbedding = (m) => String(m.family || "").toLowerCase() === "embedding";
+    const language = catalog.filter((m) => !isEmbedding(m));
+    const embeddings = catalog.filter(isEmbedding);
+    const loaded = catalog.filter((m) => String(m.state).toLowerCase() === "loaded");
+    const active = catalog.find((m) => m.id === data.current)
+      || loaded.find((m) => !isEmbedding(m))
+      || language[0]
+      || catalog[0];
+
+    renderActive(active);
+    renderStats(catalog, embeddings, loaded);
+    renderEmbeddings(embeddings, emb);
+    renderCatalog(language.length ? language : catalog);
+  }
+
+  function renderActive(m) {
+    if (!m) { activeHost.replaceChildren(); return; }
+    activeHost.replaceChildren(
+      c.card(
+        h("div.lt3-stack-3",
+          h("div.lt3-row-2", { style: { "justify-content": "space-between", "align-items": "flex-start", "flex-wrap": "wrap", gap: "var(--lt3-space-3)" } },
+            h("div.lt3-row-2", { style: { "align-items": "center", gap: "var(--lt3-space-3)" } },
+              h("div.lt3-pillar__icon", { style: { background: "var(--lt3-pillar-hybrid-soft)", color: "var(--lt3-pillar-hybrid)" } }, icon("cpu")),
+              h("div",
+                h("div.lt3-eyebrow", "Active model"),
+                h("div", { style: { "font-size": "var(--lt3-text-xl)", "font-weight": 800, "letter-spacing": "-0.01em" } }, m.name || m.id),
+                h("div.lt3-faint.lt3-mono", { style: { "font-size": "var(--lt3-text-2xs)", "margin-top": "var(--lt3-space-1)" } }, m.id),
+              ),
+            ),
+            h("div.lt3-cluster", { style: { "align-items": "center" } },
+              m.recommended ? c.pill("Recommended", "info") : null,
+              c.statePill("loaded"),
+            ),
+          ),
+          h("div.lt3-cluster",
+            specChip(ctx, "category", "Family", titleCase(m.family || "local")),
+            specChip(ctx, "stack-2", "Params", m.params || "—"),
+            specChip(ctx, "binary", "Quant", m.quant || "—"),
+            specChip(ctx, "ruler-2", "Context", c.fmtNum(m.context) + " tok"),
+          ),
+        ),
+        { attrs: { style: "border-color: color-mix(in srgb, var(--lt3-pillar-hybrid) 32%, var(--border)); background: var(--lt3-pillar-hybrid-soft)" } },
+      ),
+    );
+  }
+
+  function renderStats(catalog, embeddings, loaded) {
+    const maxCtx = catalog.reduce((mx, m) => Math.max(mx, Number(m.context) || 0), 0);
+    statHost.replaceChildren(
+      c.stat({ label: "Loaded", value: c.fmtNum(loaded.length), icon: "player-play" }),
+      c.stat({ label: "Available", value: c.fmtNum(catalog.length), icon: "stack-2" }),
+      c.stat({ label: "Embedding models", value: c.fmtNum(embeddings.length), icon: "grid-dots" }),
+      c.stat({ label: "Max context", value: c.fmtNum(maxCtx) + " tok", icon: "ruler-2" }),
+    );
+  }
+
+  function renderEmbeddings(embeddings, emb) {
+    const statusCard = embeddingStatusCard(ctx, emb);
+    if (!embeddings.length) {
+      embedHost.replaceChildren(h("div.lt3-stack-4",
+        statusCard,
+        c.emptyState({ icon: "grid-dots", title: "No catalog embedding models", body: "The active provider above powers the Vector Index. Pull a semantic embedding model to list it here." }),
+      ));
+      return;
+    }
+    embedHost.replaceChildren(h("div.lt3-stack-4",
+      statusCard,
+      h("div.lt3-grid-auto",
+        embeddings.map((m) => c.card(
+          h("div.lt3-stack-2",
+            h("div.lt3-row-2", { style: { "justify-content": "space-between", "align-items": "center" } },
+              h("div.lt3-row-2", { style: { "align-items": "center" } },
+                h("span", { style: { color: "var(--lt3-pillar-vector)", display: "inline-flex" } }, icon("grid-dots")),
+                h("b", { style: { "font-size": "var(--lt3-text-sm)" } }, m.name || m.id),
+              ),
+              c.statePill(m.state),
+            ),
+            h("div.lt3-faint.lt3-mono", { style: { "font-size": "var(--lt3-text-2xs)" } }, m.id),
+            h("div.lt3-cluster",
+              c.pill(`${m.params || "—"} params`, ""),
+              c.pill(m.quant || "—", ""),
+              c.pill(`${c.fmtNum(m.context)} ctx`, ""),
+            ),
+            h("div.lt3-faint", { style: { "font-size": "var(--lt3-text-2xs)" } }, "Powers the Vector Index → Hybrid Search."),
+          ),
+          { flat: true },
+        )),
+      ),
+    ));
+  }
+
+  function renderCatalog(rows) {
+    const columns = [
+      { key: "name", label: "Model", render: (m) => h("div.lt3-stack-2", { style: { gap: "2px" } },
+          h("b", { style: { "font-size": "var(--lt3-text-sm)" } }, m.name || m.id),
+          h("span.lt3-faint.lt3-mono", { style: { "font-size": "var(--lt3-text-2xs)" } }, m.id),
+        ) },
+      { key: "family", label: "Family", render: (m) => titleCase(m.family || "local") },
+      { key: "params", label: "Params", render: (m) => h("span.lt3-mono", m.params || "—") },
+      { key: "quant", label: "Quant", render: (m) => h("span.lt3-mono", m.quant || "—") },
+      { key: "context", label: "Context", render: (m) => h("span.lt3-mono", c.fmtNum(m.context)) },
+      { key: "state", label: "State", render: (m) => c.statePill(m.state) },
+      { key: "action", label: "", width: "1%", render: (m) => actionButton(m) },
+    ];
+    tableHost.replaceChildren(
+      c.table(columns, rows, {
+        empty: c.emptyState({ icon: "cpu-off", title: "No language models", body: "Pull an MLX chat model into the runtime." }),
+      }),
+    );
+  }
+
+  function actionButton(m) {
+    const loaded = String(m.state).toLowerCase() === "loaded";
+    const label = loaded ? "Unload" : "Load";
+    const ic = loaded ? "player-stop" : "player-play";
+    return h("button.lt3-btn.lt3-btn--ghost.lt3-btn--sm",
+      { "aria-label": `${label} ${m.name || m.id}`, on: { click: () => toggleModel(m) } },
+      icon(ic), label,
+    );
+  }
+
+  async function toggleModel(m) {
+    const loaded = String(m.state).toLowerCase() === "loaded";
+    const res = loaded ? await ctx.api.unloadModel(m.id) : await ctx.api.loadModel(m.id, m.recommended_engine);
+    if (res && res.ok && res.data && !res.data.detail && !res.data.error) {
+      ctx.toast(`${loaded ? "Unloaded" : "Loaded"} ${m.name || m.id}.`, "ok");
+      load();
+    } else {
+      const detail = (res && res.data && (res.data.detail || res.data.error)) || "model runtime unavailable";
+      ctx.toast(`Could not ${loaded ? "unload" : "load"} ${m.name || m.id} — ${detail}.`, "warn");
+    }
+  }
+
+  load();
+  return root;
+}
+
+/* ── Active embedding provider status (real /api/embeddings/status) ──────── */
+function embeddingStatusCard(ctx, emb) {
+  const { h, icon, c } = ctx;
+  const d = (emb && emb.data) || {};
+  const state = String(d.state || d.grade || "fallback").toLowerCase();
+  const statusPill = state === "production" ? c.pill("Production", "ok")
+    : state === "unavailable" ? c.pill("Unavailable", "err")
+    : c.pill("Fallback", "warn");
+  const label = ({ hash: "Local hash (fallback)", mlx: "MLX (Apple Silicon)", ollama: "Ollama",
+    openai: "OpenAI-compatible", custom: "Custom" }[String(d.active_provider || d.provider || "hash")]) || String(d.active_provider || "—");
+  const lastIndexed = d.last_indexed_at ? new Date(d.last_indexed_at).toLocaleString() : "Never";
+  return c.card(
+    h("div.lt3-stack-3",
+      h("div.lt3-row", { style: { "justify-content": "space-between", "align-items": "center", "flex-wrap": "wrap", gap: "var(--lt3-space-3)" } },
+        h("div.lt3-row-2", { style: { "align-items": "center" } },
+          h("span", { style: { color: "var(--lt3-pillar-vector)", display: "inline-flex" } }, icon("grid-dots")),
+          h("div",
+            h("div.lt3-eyebrow", "Active provider"),
+            h("b", { style: { "font-size": "var(--lt3-text-md)" } }, label),
+          ),
+        ),
+        h("div.lt3-row-2", { style: { "align-items": "center" } }, statusPill, c.sourceBadge((emb && emb.source) || "pending")),
+      ),
+      d.fell_back
+        ? h("div.lt3-faint", { style: { "font-size": "var(--lt3-text-2xs)", color: "var(--lt3-warn, var(--muted))" } },
+            `Requested “${d.requested_provider}” is unavailable (${(d.health && d.health.detail) || "no detail"}); using hash fallback.`)
+        : null,
+      h("div.lt3-cluster",
+        specChip(ctx, "category", "Model", d.model || d.model_id || "—"),
+        specChip(ctx, "ruler-2", "Dimensions", String(d.dimensions || "—")),
+        specChip(ctx, "clock", "Last index", lastIndexed),
+      ),
+    ),
+    { attrs: { style: "border-color: color-mix(in srgb, var(--lt3-pillar-vector) 28%, var(--border)); background: var(--lt3-pillar-vector-soft, transparent)" } },
+  );
+}
+
+/* ── helpers ─────────────────────────────────────────────────────────────── */
+function specChip({ h, icon }, ic, label, value) {
+  return h("span.lt3-pill",
+    h("span", { style: { color: "var(--faint)", display: "inline-flex" } }, icon(ic)),
+    h("span.lt3-faint", { style: { "font-size": "var(--lt3-text-2xs)" } }, label),
+    h("b", { style: { "font-size": "var(--lt3-text-xs)" } }, value),
+  );
+}
+
+function titleCase(s) {
+  s = String(s || "");
+  return s ? s.charAt(0).toUpperCase() + s.slice(1) : s;
+}