ltcai 2.2.7 → 3.0.1

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

@@ -0,0 +1,247 @@
+/* ============================================================================
+ * 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.
+ * Falls back to clearly-badged sample data when the runtime 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 }
+ * ========================================================================== */
+
+const PENDING = "Load and unload models from the classic runtime surface (/workspace → Models); this view is read-only.";
+
+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: "The current default vector signal is lattice-local-hash-v1 fallback embeddings; future local providers can replace it behind the same index.",
+      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 on this machine", body: "Pull an MLX model into the local runtime to get started." }),
+      );
+      statHost.replaceChildren();
+      renderEmbeddings([], emb);
+      tableHost.replaceChildren(c.emptyState({ icon: "cpu-off", title: "Catalog is empty", body: "Connect the MLX runtime to list installed 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: () => ctx.toast(PENDING, "info") } },
+      icon(ic), label,
+    );
+  }
+
+  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;
+}

package/static/v3/js/views/my-computer.js

@@ -0,0 +1,237 @@
+/* ============================================================================
+ * View: My Computer — local hardware, memory, and runtime.
+ * Reinforces the local-first promise: every gauge, model, and byte of memory
+ * lives on this machine. Live-reads /local/sysinfo + /models and degrades to
+ * clearly-badged sample data when those endpoints aren't available yet.
+ * ========================================================================== */
+
+const GAUGES = [
+  { key: "cpu_pct", label: "CPU", icon: "cpu", variant: "graph", sub: () => "Compute cores" },
+  { key: "ram_pct", label: "RAM", icon: "device-desktop-analytics", variant: "vector", sub: () => "Unified memory" },
+  { key: "gpu_mem_pct", label: "GPU (MLX)", icon: "brand-apple", variant: "hybrid", sub: (d) => `${fmtGb(d.gpu_mem_gb)} GB in use` },
+];
+
+export async function render(ctx) {
+  const { h, icon, api, c } = ctx;
+
+  const state = { memoryOn: false, activities: [], memSource: "pending" };
+
+  // Hydrated after the async reads land.
+  const srcSlot = h("span", c.sourceBadge("pending"));
+  const gaugeHost = h("div.lt3-grid-3", c.loading({ lines: 0, block: true }));
+  const runtimeHost = h("div", c.loading({ lines: 4 }));
+
+  const root = h("div.lt3-stack-6",
+    c.viewHeader({
+      eyebrow: "Compute",
+      title: "My Computer",
+      sub: "The local hardware and MLX runtime powering this workspace. Inference and indexing run here — on Apple Silicon — never on an external server.",
+      actions: [
+        srcSlot,
+        h("button.lt3-btn.lt3-btn--ghost", { on: { click: () => load() } }, icon("refresh"), "Refresh"),
+      ],
+    }),
+
+    c.banner("All inference and indexing happen on this computer. Nothing you index, ask, or remember is sent to external servers.", "info", "shield-lock"),
+
+    h("section",
+      c.sectionHead("Live utilization"),
+      gaugeHost,
+    ),
+
+    h("div.lt3-grid-2",
+      c.panel({
+        eyebrow: "Runtime",
+        title: "Local runtime",
+        sub: "Where this workspace runs and where it keeps its data.",
+        children: runtimeHost,
+      }),
+      buildMemoryPanel(ctx, state),
+    ),
+  );
+
+  async function load() {
+    gaugeHost.replaceChildren(c.loading({ lines: 0, block: true }));
+    runtimeHost.replaceChildren(c.loading({ lines: 4 }));
+
+    const [sys, models] = await Promise.all([api.sysinfo(), api.models()]);
+
+    srcSlot.replaceChildren(c.sourceBadge(sys.source));
+    gaugeHost.replaceChildren(buildGauges(ctx, sys));
+    runtimeHost.replaceChildren(buildRuntime(ctx, sys, models));
+  }
+
+  // Reflect real local-memory state (enabled + recorded activity) from the backend.
+  async function loadMemory() {
+    const res = await api.computerMemory();
+    const cfg = (res && res.ok && res.data) ? res.data : null;
+    state.memSource = cfg ? "live" : "placeholder";
+    state.memoryOn = !!(cfg && cfg.enabled);
+    state.activities = (cfg && Array.isArray(cfg.activities)) ? cfg.activities.slice().reverse() : [];
+    if (state._refreshMemory) state._refreshMemory();
+  }
+
+  load();
+  loadMemory();
+  return root;
+}
+
+/* ── Gauges ──────────────────────────────────────────────────────────────── */
+function buildGauges({ h, icon, c }, sys) {
+  const data = (sys && sys.data) || {};
+  return h("div.lt3-grid-3",
+    GAUGES.map((g) => {
+      const raw = Number(data[g.key]);
+      const pct = Number.isFinite(raw) ? raw : null;
+      return c.card(
+        h("div.lt3-stack-3",
+          h("div.lt3-row", { style: { "justify-content": "space-between" } },
+            h("div.lt3-stat__label", icon(g.icon), g.label),
+            c.statePill(pct == null ? "idle" : pct >= 90 ? "warn" : "active"),
+          ),
+          h("div.lt3-stat__value", { style: { "font-size": "var(--lt3-text-3xl)" } },
+            pct == null ? "—" : `${roundPct(pct)}%`),
+          c.meter(pct == null ? 0 : pct / 100, g.variant),
+          h("div.lt3-faint", { style: { "font-size": "var(--lt3-text-2xs)" } }, g.sub(data)),
+        ),
+      );
+    }),
+  );
+}
+
+/* ── Runtime key/value panel ─────────────────────────────────────────────── */
+function buildRuntime({ h, icon, c }, sys, models) {
+  const md = (models && models.data) || {};
+  const current =
+    md.current ||
+    (md.catalog || []).find((m) => m.state === "loaded")?.id ||
+    "mlx-community/local-model-4bit";
+
+  const rows = [
+    { k: "Platform", v: "Apple Silicon · MLX", icon: "brand-apple" },
+    { k: "Loaded model", v: current, mono: true, icon: "cpu" },
+    { k: "Local storage", v: "~/.ltcai", mono: true, icon: "folder" },
+    { k: "Memory model", v: "Unified memory (CPU + GPU shared)", icon: "stack-2" },
+    { k: "Network", v: "Local-only — no external inference", icon: "wifi-off" },
+  ];
+
+  return h("div",
+    h("dl.lt3-keyval",
+      rows.flatMap((r) => [
+        h("dt", h("span.lt3-row-2", icon(r.icon), r.k)),
+        h("dd", r.mono ? h("span.lt3-mono", r.v) : r.v),
+      ]),
+    ),
+    h("div.lt3-row-2", { style: { "margin-top": "var(--lt3-space-4)" } },
+      c.sourceBadge((models && models.source) || (sys && sys.source)),
+      h("span.lt3-faint", { style: { "font-size": "var(--lt3-text-2xs)" } }, "Derived from local runtime"),
+    ),
+  );
+}
+
+/* ── Local memory panel (wired to /workspace/computer-memory) ─────────────── */
+function buildMemoryPanel(ctx, state) {
+  const { h, icon, c } = ctx;
+  const notify = ctx.toast || c.toast;
+
+  const activityHost = h("div", renderActivity(ctx, state));
+  const input = h("input", {
+    type: "checkbox",
+    "aria-label": "Enable local computer memory",
+    checked: state.memoryOn,
+    on: {
+      change: async (e) => {
+        const want = e.target.checked;
+        input.disabled = true;
+        const res = await ctx.api.setComputerMemory(want);
+        input.disabled = false;
+        if (res && res.ok) {
+          state.memoryOn = want;
+          state.memSource = "live";
+          const cfg = res.data || {};
+          state.activities = Array.isArray(cfg.activities) ? cfg.activities.slice().reverse() : state.activities;
+          refresh();
+          notify(
+            want
+              ? "Local memory enabled — context persists on this computer (~/.ltcai)."
+              : "Local memory disabled. Nothing will be persisted on this computer.",
+            want ? "ok" : "info",
+          );
+        } else {
+          // Revert the toggle; report the real reason (e.g. 403 consent, no backend).
+          e.target.checked = state.memoryOn;
+          const detail = (res && res.data && (res.data.detail || res.data.error)) || "the runtime is unavailable";
+          notify(`Could not change local memory — ${detail}.`, "warn");
+        }
+      },
+    },
+  });
+
+  // Built from the frozen .lt3-switch markup (input + span); no shared file touched.
+  const sw = h("label.lt3-switch", { title: "Enable local computer memory" }, input, h("span"));
+
+  function refresh() {
+    input.checked = state.memoryOn;
+    activityHost.replaceChildren(renderActivity(ctx, state));
+  }
+  state._refreshMemory = refresh;
+
+  return c.panel({
+    eyebrow: "On-device",
+    title: "Local memory",
+    sub: "Let the assistant remember context across sessions — stored only on this computer, never uploaded.",
+    children: h("div.lt3-stack-4",
+      h("div.lt3-row", { style: { "justify-content": "space-between", "align-items": "flex-start" } },
+        h("div.lt3-stack-2", { style: { "max-width": "40ch" } },
+          h("div", { style: { "font-weight": "var(--lt3-weight-semi)", "font-size": "var(--lt3-text-sm)" } },
+            "Enable local computer memory"),
+          h("div.lt3-faint", { style: { "font-size": "var(--lt3-text-2xs)" } },
+            "Persists to ~/.ltcai. Off by default."),
+        ),
+        sw,
+      ),
+      h("div",
+        h("div.lt3-row", { style: { "justify-content": "space-between", "align-items": "center", "margin-bottom": "var(--lt3-space-2)" } },
+          h("div.lt3-eyebrow", "Recent local activity"),
+          h("span", { "data-mem-src": "1" }, c.sourceBadge(state.memSource)),
+        ),
+        activityHost,
+      ),
+    ),
+  });
+}
+
+function renderActivity({ h, icon, c }, state) {
+  if (!state.memoryOn) {
+    return c.emptyState({
+      icon: "database-off",
+      title: "Memory is off",
+      body: "Enable local memory to let the assistant retain context on this computer.",
+    });
+  }
+  const items = Array.isArray(state.activities) ? state.activities : [];
+  if (!items.length) {
+    return c.emptyState({
+      icon: "history-off",
+      title: "No activity recorded yet",
+      body: "Once memory is on, on-device actions the assistant takes will be logged here.",
+    });
+  }
+  return h("div.lt3-list",
+    items.slice(0, 8).map((a) => h("div.lt3-list__item",
+      icon(a.icon || "activity"),
+      h("div.lt3-list__body",
+        h("div.lt3-list__title", a.title || a.action || a.kind || "Activity"),
+        h("div.lt3-list__meta", a.meta || a.detail || a.timestamp || ""),
+      ),
+      c.statePill(a.state || "ok"),
+    )),
+  );
+}
+
+/* ── helpers ─────────────────────────────────────────────────────────────── */
+function roundPct(n) { return Math.round(Number(n) * 10) / 10; }
+function fmtGb(n) {
+  const v = Number(n);
+  return Number.isFinite(v) ? (Math.round(v * 10) / 10).toString() : "—";
+}

package/static/v3/js/views/pipeline.js

@@ -0,0 +1,161 @@
+/* ============================================================================
+ * View: Pipeline — ingest / embed / graph-build flows.
+ * Renders each workspace workflow as a horizontal stage flow (integration-ready
+ * against /workspace/workflows and the index APIs). Pipelines execute on the
+ * local runtime; this surface visualizes their stages and run state, falling
+ * back to clearly-badged sample data until the backend route is available.
+ * ========================================================================== */
+
+import { timeAgo } from "../core/dom.js";
+import * as fx from "../core/fixtures.js";
+
+export async function render(ctx) {
+  const { h, icon, api, c, toast } = ctx;
+
+  // Pipeline authoring (defining new multi-stage flows) is not available from
+  // this view in this build — say so plainly instead of implying it's coming.
+  const unavailable = (label) => () => toast(`${label} is managed from the classic workflow designer — not available from this view.`, "warn");
+
+  const statHost = h("div.lt3-statrow", c.loading({ lines: 1 }));
+  const srcSlot = h("span", c.sourceBadge("pending"));
+  const flowsHost = h("div.lt3-stack-6", c.loading({ lines: 3, block: true }));
+
+  const rebuildBtn = h("button.lt3-btn.lt3-btn--primary", { on: { click: () => rebuild() } }, icon("refresh"), "Rebuild index");
+
+  const root = h("div.lt3-stack-6",
+    c.viewHeader({
+      eyebrow: "Data",
+      title: "Pipeline",
+      sub: "Ingest, embed, and graph-build flows that turn your sources into the retrieval lattice — chunk, embed, extract entities, and link the graph.",
+      actions: [rebuildBtn],
+    }),
+    c.banner(
+      "Pipelines execute on this machine's local runtime. Use Rebuild index to re-embed every chunk and relink the knowledge graph from your current sources.",
+      "info",
+      "server-bolt",
+    ),
+    statHost,
+    h("section",
+      c.sectionHead("Flows", srcSlot),
+      flowsHost,
+    ),
+  );
+
+  load();
+  return root;
+
+  async function load() {
+    const res = await api.get("/workspace/workflows", { workflows: fx.PIPELINES });
+    const pipelines = normalize(res.data);
+    srcSlot.replaceChildren(c.sourceBadge(res.source));
+    renderStats(pipelines);
+    renderFlows(pipelines);
+  }
+
+  // Real pipeline run: rebuild the vector index (re-embed chunks, relink graph).
+  async function rebuild() {
+    rebuildBtn.disabled = true;
+    rebuildBtn.replaceChildren(icon("loader"), "Rebuilding…");
+    const res = await api.rebuildIndex();
+    rebuildBtn.disabled = false;
+    rebuildBtn.replaceChildren(icon("refresh"), "Rebuild index");
+    if (res && res.ok && res.data && res.data.status === "completed") {
+      const d = res.data;
+      toast(`Index rebuilt — ${d.items_indexed} indexed, ${d.items_skipped} unchanged (${d.embedding_model}).`, "ok");
+      load();
+    } else {
+      const detail = (res && res.data && (res.data.detail || res.data.error)) || "the knowledge graph is unavailable";
+      toast(`Could not rebuild the index — ${detail}.`, "warn");
+    }
+  }
+
+  function renderStats(pipelines) {
+    const active = pipelines.filter((p) => isActive(p.state)).length;
+    const stages = pipelines.reduce((sum, p) => sum + p.stages.length, 0);
+    const throughput = pipelines.find((p) => p.throughput)?.throughput || "—";
+    const lastRun = pipelines
+      .map((p) => p.last_run)
+      .filter(Boolean)
+      .sort((a, b) => new Date(b) - new Date(a))[0];
+    statHost.replaceChildren(
+      c.stat({ label: "Active pipelines", value: c.fmtNum(active), icon: "player-play" }),
+      c.stat({ label: "Total stages", value: c.fmtNum(stages), icon: "stack-2" }),
+      c.stat({ label: "Throughput", value: throughput, icon: "gauge" }),
+      c.stat({ label: "Last run", value: lastRun ? timeAgo(lastRun) : "—", icon: "history" }),
+    );
+  }
+
+  function renderFlows(pipelines) {
+    if (!pipelines.length) {
+      flowsHost.replaceChildren(
+        c.emptyState({
+          icon: "git-branch-deleted",
+          title: "No pipelines yet",
+          body: "Connect a source and create a pipeline to ingest, embed, and build the graph.",
+          action: h("button.lt3-btn.lt3-btn--ghost.lt3-btn--sm", { on: { click: () => rebuild() } }, icon("refresh"), "Rebuild index"),
+        }),
+      );
+      return;
+    }
+    flowsHost.replaceChildren(...pipelines.map((p) => pipelinePanel(p)));
+  }
+
+  function pipelinePanel(p) {
+    return c.panel({
+      head: h("div.lt3-row", { style: { "justify-content": "space-between", "flex-wrap": "wrap", gap: "var(--lt3-space-3)" } },
+        h("div.lt3-row-2",
+          h("div.lt3-eyebrow", icon("git-branch"), "Pipeline"),
+        ),
+        c.statePill(p.state),
+      ),
+      children: h("div.lt3-stack-4",
+        h("h3.lt3-panel__title", { style: { "margin-top": "calc(-1 * var(--lt3-space-2))" } }, p.name),
+        flowDiagram(p.stages),
+        pipelineFooter(p),
+      ),
+    });
+  }
+
+  function flowDiagram(stages) {
+    const cells = [];
+    stages.forEach((stage, i) => {
+      if (i > 0) cells.push(h("div.lt3-flow__arrow", { "aria-hidden": "true" }, icon("chevron-right")));
+      cells.push(
+        h("div.lt3-stage",
+          h("div.lt3-stage__num", String(i + 1).padStart(2, "0")),
+          h("div.lt3-stage__name", stage),
+        ),
+      );
+    });
+    return h("div.lt3-flow", { role: "list", "aria-label": "Pipeline stages" }, cells);
+  }
+
+  function pipelineFooter(p) {
+    return h("div.lt3-row", { style: { "justify-content": "space-between", "flex-wrap": "wrap", gap: "var(--lt3-space-3)" } },
+      h("div.lt3-cluster",
+        h("span.lt3-faint.lt3-row-2", { style: { "font-size": "var(--lt3-text-xs)" } }, icon("history"), p.last_run ? timeAgo(p.last_run) : "—"),
+        h("span.lt3-faint.lt3-row-2", { style: { "font-size": "var(--lt3-text-xs)" } }, icon("gauge"), p.throughput || "—"),
+      ),
+      h("button.lt3-btn.lt3-btn--ghost.lt3-btn--sm", { on: { click: unavailable(`Running "${p.name}"`) } }, icon("player-play"), "Run"),
+    );
+  }
+}
+
+/* ── helpers ─────────────────────────────────────────────────────────────── */
+function normalize(data) {
+  const list = Array.isArray(data) ? data : (data && data.workflows) || [];
+  return list.map((p, i) => ({
+    id: p.id || `pl-${i}`,
+    name: p.name || p.label || "Untitled pipeline",
+    state: p.state || "idle",
+    stages: Array.isArray(p.stages) ? p.stages.map((s) => String(s))
+      : Array.isArray(p.steps) ? p.steps.map((s) => (s && (s.action || s.name)) || String(s))
+      : [],
+    last_run: p.last_run || p.created_at || null,
+    throughput: p.throughput || "",
+  }));
+}
+
+function isActive(state) {
+  return ["active", "running", "indexing", "building"].includes(String(state).toLowerCase());
+}