nodedex 0.1.0

package/tui-dist/onboarding.js

@@ -0,0 +1,498 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// onboarding.tsx — first-run setup wizard (static, no animation).
+//
+// Flow: welcome → consent → provider → {OpenRouter: key → model | Local: endpoint → model}
+//   → port → db → capture (host discovery + per-host consent) → bind → starting → connect.
+// Two model paths: OpenRouter (cloud, BYO key) or Local / self-hosted (Ollama/LM Studio/vLLM —
+// offline, no key, $0). After the DB, a bind-mode step asks WHERE the agent runs: this machine
+// (localhost, no token) or Docker/remote (0.0.0.0 + a generated token) — the connect screen then
+// shows the right URL (+ the token to hand the agent). Onboarding sets up + starts the SERVER.
+// Connecting an autonomous agent (e.g. Hermes) to the running /mcp endpoint + wiring
+// capture is the USER's own step — the final screen points at the GitHub README for the
+// format. Config + secrets go to ~/.nodedex/config.json and are injected into the server
+// the TUI launches (servers.ts). Rolls its own inputs + spinner (no input/spinner deps).
+import { useState, useEffect, useCallback } from "react";
+import { Box, Text, useApp, useInput } from "ink";
+import { Logo } from "./components.js";
+import { theme } from "./theme.js";
+import { saveConfig, DEFAULT_PORT, DEFAULT_LOCAL_BASE_URL, RECOMMENDED_MODELS, isTrainsOnPrompts, validateOpenRouterKey, listDbs, dbPathForName, scanLocalModels, scanCaptureHosts, setHermesCapture, setClaudeCapture, } from "./config.js";
+import { launchServer, genToken, launchWatcher, stopWatcher } from "./servers.js";
+import { probeServer, setBase } from "./api.js";
+import { writeConnectSnippets } from "./connect-snippets.js";
+const README_URL = "https://github.com/NodeDex/NodeDex-v0.1#connect-your-agent";
+// Show a secret's prefix (confirms shape) but mask the tail.
+function maskSecret(k) {
+    if (!k)
+        return "";
+    if (k.length <= 10)
+        return k;
+    return k.slice(0, 8) + "•".repeat(Math.min(k.length - 8, 28));
+}
+function Spinner() {
+    const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+    const [i, setI] = useState(0);
+    useEffect(() => {
+        const id = setInterval(() => setI((n) => (n + 1) % frames.length), 80);
+        return () => clearInterval(id);
+    }, []);
+    return _jsx(Text, { color: theme.accent, children: frames[i] });
+}
+function Frame({ children }) {
+    return (_jsxs(Box, { flexDirection: "column", alignItems: "center", marginTop: 1, children: [_jsx(Logo, {}), _jsx(Box, { flexDirection: "column", alignItems: "center", marginTop: 1, width: 66, children: children })] }));
+}
+function FieldBox({ label, value, focused, mask, placeholder }) {
+    const shown = mask ? maskSecret(value) : value;
+    return (_jsxs(Box, { borderStyle: "round", borderColor: focused ? theme.borderHot : theme.border, paddingX: 1, width: 56, children: [_jsx(Box, { width: 7, children: _jsx(Text, { color: theme.label, children: label }) }), _jsx(Text, { color: value ? theme.value : theme.dim, children: shown || placeholder || " " }), focused ? _jsx(Text, { color: theme.accent, children: "\u258F" }) : null] }));
+}
+function Hint({ keys }) {
+    return (_jsx(Box, { marginTop: 1, children: keys.map(([k, label], i) => (_jsxs(Box, { children: [_jsx(Text, { color: theme.accent, children: `[${k}]` }), _jsx(Text, { color: theme.dim, children: ` ${label}${i < keys.length - 1 ? "    " : ""}` })] }, k))) }));
+}
+/** A vertical pick-list row: ▸ marker + bold-on-select + a dim note/aside. */
+function Row({ selected, label, width, aside, asideColor }) {
+    return (_jsxs(Box, { children: [_jsx(Text, { color: selected ? theme.accent : theme.dim, children: selected ? "▸ " : "  " }), _jsx(Box, { width: width, children: _jsx(Text, { bold: selected, color: selected ? theme.value : theme.dim, children: label }) }), typeof aside === "string" ? _jsx(Text, { color: asideColor ?? theme.dim, children: aside }) : aside] }));
+}
+export function Onboarding({ onDone }) {
+    const { exit } = useApp();
+    const [step, setStep] = useState("welcome");
+    const [orKey, setOrKey] = useState("");
+    // provider step (0 = OpenRouter cloud, 1 = Local/self-hosted) + local fields
+    const [providerSel, setProviderSel] = useState(0);
+    const [localBaseUrl, setLocalBaseUrl] = useState(DEFAULT_LOCAL_BASE_URL);
+    const [localModel, setLocalModel] = useState("");
+    // local-scan step: discovered models + selection (=== length → "enter manually")
+    const [localScanning, setLocalScanning] = useState(false);
+    const [localModels, setLocalModels] = useState([]);
+    const [localModelSel, setLocalModelSel] = useState(0);
+    const [localScanNonce, setLocalScanNonce] = useState(0); // bump to rescan
+    const [busy, setBusy] = useState(false);
+    const [error, setError] = useState("");
+    const [status, setStatus] = useState("");
+    // model step
+    const [modelSel, setModelSel] = useState(0); // index into RECOMMENDED_MODELS; === length → custom
+    const [customModel, setCustomModel] = useState("");
+    // port step
+    const [freePorts, setFreePorts] = useState([]);
+    const [portSel, setPortSel] = useState(0);
+    const [chosenPort, setChosenPort] = useState(DEFAULT_PORT);
+    // db step
+    const [dbs] = useState(() => listDbs());
+    const [dbSel, setDbSel] = useState(0); // 0..dbs.length-1 existing; === dbs.length → new
+    const [newDbName, setNewDbName] = useState("");
+    // capture step: discovered hosts + per-host consent checkbox
+    const [captureHosts, setCaptureHosts] = useState([]);
+    const [captureSel, setCaptureSel] = useState(0);
+    const [captureChecked, setCaptureChecked] = useState({});
+    // connect step
+    const [serverUrl, setServerUrl] = useState("");
+    // bind step (where will the agent run) + launch details for the connect screen
+    const [chosenDbPath, setChosenDbPath] = useState("");
+    const [bindSel, setBindSel] = useState(0); // 0 = this machine, 1 = docker/remote
+    const [launchNetwork, setLaunchNetwork] = useState(false);
+    const [launchToken, setLaunchToken] = useState(undefined);
+    // Scan local LLM servers when entering the local-scan step (so the user picks a model, not a
+    // URL). Re-runs when localScanNonce bumps ([r] rescan — e.g. after starting the server).
+    useEffect(() => {
+        if (step !== "localscan")
+            return;
+        let cancelled = false;
+        setLocalScanning(true);
+        setError("");
+        scanLocalModels().then((models) => {
+            if (cancelled)
+                return;
+            setLocalModels(models);
+            setLocalModelSel(0);
+            setLocalScanning(false);
+        });
+        return () => { cancelled = true; };
+    }, [step, localScanNonce]);
+    // Detect free ports when entering the port step (reuse probeServer: a port with no
+    // Nodedex responding is free enough to claim; launch fails loudly otherwise).
+    useEffect(() => {
+        if (step !== "port" || freePorts.length > 0)
+            return;
+        let cancelled = false;
+        (async () => {
+            setStatus("Scanning for free ports…");
+            const found = [];
+            for (const p of [3001, 3002, 3003, 3004, 3005, 3006, 3007, 3008]) {
+                const probe = await probeServer(`http://localhost:${p}`);
+                if (!probe.up)
+                    found.push(p);
+                if (found.length >= 5)
+                    break;
+            }
+            if (cancelled)
+                return;
+            setStatus("");
+            setFreePorts(found.length ? found : [DEFAULT_PORT]);
+            setPortSel(0);
+        })();
+        return () => { cancelled = true; };
+    }, [step, freePorts.length]);
+    // Launch the server with the chosen port + db, poll until up, then hand off to connect.
+    const finishSetup = useCallback(async (port, dbPath, bindHost, token) => {
+        setStep("starting");
+        setStatus("Starting the Nodedex server (downloading the local embedding model on first run — one-time)…");
+        setError("");
+        const res = launchServer({ port, dbPath, bindHost, token });
+        if (!res.ok) {
+            setBusy(false);
+            setStatus("");
+            setError(`Server failed to start: ${res.error}`);
+            setStep("db");
+            return;
+        }
+        const url = `http://localhost:${port}`;
+        const deadline = Date.now() + 30000;
+        while (Date.now() < deadline) {
+            const probe = await probeServer(url);
+            if (probe.up) {
+                setBase(url);
+                setBusy(false);
+                setServerUrl(url);
+                // Ready-to-paste per-host connect config → ~/.nodedex/connect-snippets.md.
+                // Regenerated on every launch so the port/token in it always match this server.
+                const network = bindHost === "0.0.0.0";
+                writeConnectSnippets({
+                    mcpUrl: network ? `http://host.docker.internal:${port}/mcp` : `http://127.0.0.1:${port}/mcp`,
+                    token,
+                    readmeUrl: README_URL,
+                });
+                setStep("connect");
+                return;
+            }
+            await new Promise((r) => setTimeout(r, 500));
+        }
+        setBusy(false);
+        setStatus("");
+        setError("Server didn't come up in time — see ~/.nodedex/tui-logs/.");
+        setStep("db");
+    }, []);
+    const submitProvider = useCallback(() => {
+        setError("");
+        setStep(providerSel === 1 ? "localscan" : "openrouter");
+    }, [providerSel]);
+    const submitLocalScan = useCallback(() => {
+        if (localModelSel >= localModels.length) {
+            setError("");
+            setStep("localendpoint");
+            return;
+        } // manual entry
+        const pick = localModels[localModelSel];
+        saveConfig({ provider: "local", base_url: pick.baseUrl, model: pick.model });
+        setError("");
+        setStep("port");
+    }, [localModelSel, localModels]);
+    const submitLocalEndpoint = useCallback(() => {
+        const url = localBaseUrl.trim();
+        if (!url) {
+            setError("Enter your local endpoint URL (e.g. http://localhost:11434/v1).");
+            return;
+        }
+        saveConfig({ provider: "local", base_url: url });
+        setError("");
+        setStep("localmodel");
+    }, [localBaseUrl]);
+    const submitLocalModel = useCallback(() => {
+        const m = localModel.trim();
+        if (!m) {
+            setError("Enter the model id your server serves (e.g. qwen3:30b).");
+            return;
+        }
+        saveConfig({ model: m });
+        setError("");
+        setStep("port");
+    }, [localModel]);
+    const submitOpenRouter = useCallback(async () => {
+        const k = orKey.trim();
+        if (!k) {
+            setError("Paste your OpenRouter API key first.");
+            return;
+        }
+        // Shape check before the network call: catches a truncated paste fast (a long key pasted
+        // into a terminal can drop characters) with a clearer message than a generic 401.
+        if (!/^sk-or-/.test(k) || k.length < 40) {
+            setError("That doesn't look like a full OpenRouter key (sk-or-…, ~73 chars). A long paste can get cut off — re-paste the whole key.");
+            return;
+        }
+        setBusy(true);
+        setError("");
+        setStatus("Verifying key…");
+        const v = await validateOpenRouterKey(k);
+        if (!v.ok) {
+            setBusy(false);
+            setStatus("");
+            setError(v.error || "Invalid key.");
+            return;
+        }
+        saveConfig({ provider: "openrouter", openrouter_key: k });
+        setBusy(false);
+        setStatus("");
+        setModelSel(0);
+        setStep("model");
+    }, [orKey]);
+    const submitModel = useCallback(() => {
+        const m = modelSel >= RECOMMENDED_MODELS.length ? customModel.trim() : RECOMMENDED_MODELS[modelSel].id;
+        if (!m) {
+            setError("Pick a model or type a custom id.");
+            return;
+        }
+        saveConfig({ model: m });
+        setError("");
+        setStep("port");
+    }, [modelSel, customModel]);
+    const submitPort = useCallback(() => {
+        const port = freePorts[portSel] ?? DEFAULT_PORT;
+        setChosenPort(port);
+        saveConfig({ port });
+        setError("");
+        setStep("db");
+    }, [freePorts, portSel]);
+    const submitDb = useCallback(() => {
+        let dbPath;
+        if (dbSel >= dbs.length) {
+            const name = newDbName.trim();
+            if (!name) {
+                setError("Name your new database.");
+                return;
+            }
+            dbPath = dbPathForName(name);
+        }
+        else {
+            dbPath = dbs[dbSel].path;
+        }
+        saveConfig({ dbPath, onboarded: true });
+        setChosenDbPath(dbPath);
+        // Discover capture hosts for the consent step (cheap existence probes, no cooperation needed).
+        const hosts = scanCaptureHosts();
+        setCaptureHosts(hosts);
+        setCaptureChecked(Object.fromEntries(hosts.map((h) => [h.host, h.found]))); // found → pre-checked
+        setCaptureSel(0);
+        setError("");
+        setStep("capture");
+    }, [dbSel, dbs, newDbName]);
+    // Persist per-host capture consent + converge the watchers to it, then on to bind.
+    const submitCapture = useCallback(() => {
+        const on = (h) => captureHosts.some((x) => x.host === h && x.found) && !!captureChecked[h];
+        setHermesCapture({ enabled: on("hermes") });
+        setClaudeCapture({ enabled: on("claude-code") });
+        if (on("hermes"))
+            launchWatcher("hermes");
+        else
+            stopWatcher("hermes");
+        if (on("claude-code"))
+            launchWatcher("claude-code");
+        else
+            stopWatcher("claude-code");
+        setError("");
+        setBindSel(0);
+        setStep("bind");
+    }, [captureHosts, captureChecked]);
+    // After the db, ask WHERE the agent runs → localhost (no token) or 0.0.0.0 + generated token.
+    const submitBind = useCallback(() => {
+        const network = bindSel === 1;
+        const token = network ? genToken() : undefined;
+        setLaunchNetwork(network);
+        setLaunchToken(token);
+        setError("");
+        void finishSetup(chosenPort, chosenDbPath, network ? "0.0.0.0" : undefined, token);
+    }, [bindSel, chosenPort, chosenDbPath, finishSetup]);
+    const typeInto = (setter, input, k) => {
+        if (k.backspace || k.delete)
+            setter((s) => s.slice(0, -1));
+        else if (input && !k.ctrl && !k.meta && !k.tab && !k.return && !k.escape)
+            setter((s) => s + input.replace(/[\r\n]/g, ""));
+        setError("");
+    };
+    useInput((input, k) => {
+        if (k.ctrl && input === "c") {
+            exit();
+            return;
+        }
+        if (busy)
+            return;
+        if (step === "welcome") {
+            if (k.return)
+                setStep("consent");
+            else if (input === "q")
+                exit();
+        }
+        else if (step === "consent") {
+            if (k.return)
+                setStep("provider");
+            else if (input === "q")
+                exit();
+        }
+        else if (step === "provider") {
+            if (k.upArrow || k.downArrow)
+                setProviderSel((s) => (s === 0 ? 1 : 0));
+            else if (k.escape)
+                setStep("consent");
+            else if (k.return)
+                submitProvider();
+        }
+        else if (step === "openrouter") {
+            if (k.return)
+                void submitOpenRouter();
+            else if (k.escape)
+                setStep("provider");
+            else
+                typeInto(setOrKey, input, k);
+        }
+        else if (step === "localscan") {
+            if (localScanning)
+                return;
+            const total = localModels.length + 1; // + "enter manually" row
+            if (k.upArrow)
+                setLocalModelSel((s) => (s - 1 + total) % total);
+            else if (k.downArrow)
+                setLocalModelSel((s) => (s + 1) % total);
+            else if (k.escape)
+                setStep("provider");
+            else if (input === "r")
+                setLocalScanNonce((n) => n + 1);
+            else if (k.return)
+                submitLocalScan();
+        }
+        else if (step === "localendpoint") {
+            if (k.return)
+                submitLocalEndpoint();
+            else if (k.escape)
+                setStep("localscan");
+            else
+                typeInto(setLocalBaseUrl, input, k);
+        }
+        else if (step === "localmodel") {
+            if (k.return)
+                submitLocalModel();
+            else if (k.escape)
+                setStep("localendpoint");
+            else
+                typeInto(setLocalModel, input, k);
+        }
+        else if (step === "model") {
+            const total = RECOMMENDED_MODELS.length + 1; // + custom row
+            if (k.upArrow)
+                setModelSel((s) => (s - 1 + total) % total);
+            else if (k.downArrow)
+                setModelSel((s) => (s + 1) % total);
+            else if (k.escape)
+                setStep("openrouter");
+            else if (k.return)
+                submitModel();
+            else if (modelSel >= RECOMMENDED_MODELS.length)
+                typeInto(setCustomModel, input, k);
+        }
+        else if (step === "port") {
+            if (freePorts.length === 0)
+                return; // still scanning
+            if (k.upArrow)
+                setPortSel((s) => (s - 1 + freePorts.length) % freePorts.length);
+            else if (k.downArrow)
+                setPortSel((s) => (s + 1) % freePorts.length);
+            else if (k.return)
+                submitPort();
+            else if (k.escape)
+                setStep(providerSel === 1 ? "localscan" : "model");
+        }
+        else if (step === "db") {
+            const total = dbs.length + 1; // + new row
+            if (k.upArrow)
+                setDbSel((s) => (s - 1 + total) % total);
+            else if (k.downArrow)
+                setDbSel((s) => (s + 1) % total);
+            else if (k.escape)
+                setStep("port");
+            else if (k.return)
+                submitDb();
+            else if (dbSel >= dbs.length)
+                typeInto(setNewDbName, input, k);
+        }
+        else if (step === "capture") {
+            if (k.upArrow)
+                setCaptureSel((s) => Math.max(0, s - 1));
+            else if (k.downArrow)
+                setCaptureSel((s) => Math.min(captureHosts.length - 1, s + 1));
+            else if (input === " ") {
+                const h = captureHosts[captureSel];
+                if (h?.found)
+                    setCaptureChecked((c) => ({ ...c, [h.host]: !c[h.host] }));
+            }
+            else if (k.return)
+                submitCapture();
+            else if (k.escape)
+                setStep("db");
+        }
+        else if (step === "bind") {
+            if (k.upArrow || k.downArrow)
+                setBindSel((s) => (s === 0 ? 1 : 0));
+            else if (k.escape)
+                setStep("capture");
+            else if (k.return)
+                submitBind();
+        }
+        else if (step === "connect") {
+            if (k.return)
+                onDone();
+        }
+    });
+    if (step === "welcome") {
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.value, children: "Welcome \u2014 let's get your agent's memory set up." }), _jsx(Hint, { keys: [["Enter", "begin"], ["q", "quit"]] })] }));
+    }
+    if (step === "consent") {
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "Before you start" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: theme.value, children: "\u00B7 Nodedex stores your work as a knowledge graph on your machine." }), _jsx(Text, { color: theme.value, children: "\u00B7 An AI pipeline builds your agent's memory from your turns \u2014 it" }), _jsx(Text, { color: theme.value, children: "  can be wrong or incomplete; the agent's notes, not ground truth." }), _jsx(Text, { color: theme.value, children: "\u00B7 You bring your own model \u2014 a cloud key (billed to you) or a local one." })] }), _jsx(Hint, { keys: [["Enter", "I understand & agree"], ["q", "quit"]] })] }));
+    }
+    if (step === "provider") {
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "How will you run the extraction model?" }), _jsx(Text, { color: theme.dim, children: "NodeDex's pipeline uses it to turn your turns into the graph." }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Row, { selected: providerSel === 0, label: "OpenRouter", width: 12, aside: "cloud \u2014 bring your API key (recommended)" }), _jsx(Row, { selected: providerSel === 1, label: "Local", width: 12, aside: "self-hosted (Ollama / LM Studio) \u2014 offline, no key, $0" })] }), _jsx(Hint, { keys: [["↑↓", "move"], ["Enter", "select"], ["Esc", "back"]] })] }));
+    }
+    if (step === "localscan") {
+        const manualSel = localModelSel >= localModels.length;
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "Pick a local model" }), _jsx(Text, { color: theme.dim, children: "Make sure your model server (Ollama / LM Studio / vLLM) is running first." }), localScanning ? (_jsxs(Box, { marginTop: 1, children: [_jsx(Spinner, {}), _jsx(Text, { color: theme.dim, children: ` Scanning Ollama / LM Studio / vLLM…` })] })) : (_jsxs(Box, { marginTop: 1, flexDirection: "column", children: [localModels.length === 0
+                            ? _jsx(Text, { color: theme.dim, children: "No local server found. Start it (e.g. `ollama serve`) and press [r], or enter it manually." })
+                            : localModels.map((m, i) => (_jsx(Row, { selected: i === localModelSel, label: m.model, width: 30, aside: m.baseUrl.replace(/^https?:\/\//, "") }, `${m.baseUrl}:${m.model}`))), _jsx(Row, { selected: manualSel, label: "\u2328 Enter manually", width: 30, aside: "type a URL + model id" })] })), error ? _jsx(Text, { color: theme.danger, children: `⚠ ${error}` }) : null, _jsx(Hint, { keys: [["↑↓", "move"], ["Enter", "select"], ["r", "rescan"], ["Esc", "back"]] })] }));
+    }
+    if (step === "localendpoint") {
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "Local endpoint" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", alignItems: "center", children: [_jsx(Text, { color: theme.dim, children: "Your OpenAI-compatible server (Ollama, LM Studio, vLLM)" }), _jsx(Box, { marginTop: 1, children: _jsx(FieldBox, { label: "url", value: localBaseUrl, focused: true, placeholder: DEFAULT_LOCAL_BASE_URL }) }), error ? _jsx(Text, { color: theme.danger, children: `⚠ ${error}` }) : _jsx(Text, { children: " " })] }), _jsx(Hint, { keys: [["Enter", "continue"], ["Esc", "back"]] })] }));
+    }
+    if (step === "localmodel") {
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "Local model" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", alignItems: "center", children: [_jsx(Text, { color: theme.dim, children: "The model id your server serves (e.g. qwen3:30b, llama3.3)" }), _jsx(Box, { marginTop: 1, children: _jsx(FieldBox, { label: "model", value: localModel, focused: true, placeholder: "qwen3:30b" }) }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.dim, children: "A capable ~30B+ model gives the best extraction quality." }) }), error ? _jsx(Text, { color: theme.danger, children: `⚠ ${error}` }) : _jsx(Text, { children: " " })] }), _jsx(Hint, { keys: [["Enter", "continue"], ["Esc", "back"]] })] }));
+    }
+    if (step === "openrouter") {
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "Connect OpenRouter" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", alignItems: "center", children: [_jsx(Text, { color: theme.dim, children: "Get a key at openrouter.ai/keys" }), _jsx(Box, { marginTop: 1, children: _jsx(FieldBox, { label: "key", value: orKey, focused: true, mask: true, placeholder: "sk-or-..." }) }), error ? _jsx(Text, { color: theme.danger, children: `⚠ ${error}` }) : _jsx(Text, { children: " " }), status ? _jsxs(Box, { children: [_jsx(Spinner, {}), _jsx(Text, { color: theme.dim, children: ` ${status}` })] }) : null] }), _jsx(Hint, { keys: [["Enter", "verify & continue"], ["Esc", "back"]] })] }));
+    }
+    if (step === "model") {
+        const custom = modelSel >= RECOMMENDED_MODELS.length;
+        const warn = custom ? isTrainsOnPrompts(customModel) : !!RECOMMENDED_MODELS[modelSel].free;
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "Choose a model" }), _jsx(Text, { color: theme.dim, children: "OpenRouter slugs \u2014 vendor/model (custom: any OpenRouter id)" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [RECOMMENDED_MODELS.map((m, i) => (_jsx(Row, { selected: i === modelSel, label: m.label, width: 20, aside: m.note, asideColor: m.free ? theme.danger : theme.dim }, m.id))), _jsx(Row, { selected: custom, label: "Custom\u2026", width: 20, aside: custom
+                                ? _jsxs(Text, { color: customModel ? theme.value : theme.dim, children: [(customModel || "type a model id"), _jsx(Text, { color: theme.accent, children: "\u258F" })] })
+                                : "enter any model id" })] }), warn
+                    ? _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.danger, children: "\u26A0 Free \u2014 but it trains on your prompts (your inputs may be used to improve the model)." }) })
+                    : _jsx(Text, { children: " " }), error ? _jsx(Text, { color: theme.danger, children: `⚠ ${error}` }) : null, _jsx(Hint, { keys: [["↑↓", "move"], ["Enter", "select"], ["Esc", "back"]] })] }));
+    }
+    if (step === "port") {
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "Pick a port" }), freePorts.length === 0
+                    ? _jsxs(Box, { marginTop: 1, children: [_jsx(Spinner, {}), _jsx(Text, { color: theme.dim, children: ` ${status || "Scanning…"}` })] })
+                    : (_jsx(Box, { marginTop: 1, flexDirection: "column", children: freePorts.map((p, i) => (_jsx(Row, { selected: i === portSel, label: `localhost:${p}`, width: 18, aside: "free" }, p))) })), error ? _jsx(Text, { color: theme.danger, children: `⚠ ${error}` }) : null, _jsx(Hint, { keys: [["↑↓", "move"], ["Enter", "select"], ["Esc", "back"]] })] }));
+    }
+    if (step === "db") {
+        const newSel = dbSel >= dbs.length;
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "Choose a database" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [dbs.map((d, i) => (_jsx(Row, { selected: i === dbSel, label: d.name, width: 18, aside: "existing" }, d.path))), _jsx(Row, { selected: newSel, label: "\uFF0B New database", width: 18, aside: newSel
+                                ? _jsxs(Text, { color: newDbName ? theme.value : theme.dim, children: [(newDbName || "name it"), _jsx(Text, { color: theme.accent, children: "\u258F" })] })
+                                : "create + name a new graph" })] }), error ? _jsx(Text, { color: theme.danger, children: `⚠ ${error}` }) : null, _jsx(Hint, { keys: [["↑↓", "move"], ["Enter", "select"], ["Esc", "back"]] })] }));
+    }
+    if (step === "capture") {
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "Capture \u2014 which agents feed this memory?" }), _jsx(Text, { color: theme.dim, children: "NodeDex reads each host's own conversation log (read-only, on this machine)." }), _jsx(Text, { color: theme.dim, children: "Only new turns are captured \u2014 never past history. Change anytime in Settings." }), _jsx(Box, { marginTop: 1, flexDirection: "column", children: captureHosts.map((h, i) => (_jsx(Row, { selected: i === captureSel, label: `${h.found && captureChecked[h.host] ? "[✓]" : "[ ]"} ${h.label}`, width: 22, aside: h.found ? h.detail : `${h.detail} — will idle until it appears`, asideColor: h.found ? theme.value : theme.dim }, h.host))) }), error ? _jsx(Text, { color: theme.danger, children: `⚠ ${error}` }) : null, _jsx(Hint, { keys: [["↑↓", "move"], ["space", "toggle"], ["Enter", "continue"], ["Esc", "back"]] })] }));
+    }
+    if (step === "bind") {
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "Where will your agent run?" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Row, { selected: bindSel === 0, label: "This machine", width: 20, aside: "localhost \u2014 simplest & private, no token" }), _jsx(Row, { selected: bindSel === 1, label: "Docker / remote", width: 20, aside: "0.0.0.0 + token \u2014 agent in a container or on another machine" })] }), error ? _jsx(Text, { color: theme.danger, children: `⚠ ${error}` }) : null, _jsx(Hint, { keys: [["↑↓", "move"], ["Enter", "start server"], ["Esc", "back"]] })] }));
+    }
+    if (step === "connect") {
+        const mcpUrl = launchNetwork
+            ? `http://host.docker.internal:${chosenPort}/mcp`
+            : `${serverUrl.replace("localhost", "127.0.0.1")}/mcp`;
+        return (_jsxs(Frame, { children: [_jsx(Text, { color: theme.title, bold: true, children: "\u2713 Server running" }), _jsxs(Box, { marginTop: 1, flexDirection: "column", alignItems: "center", children: [_jsx(Text, { color: theme.value, children: mcpUrl }), launchNetwork ? (_jsxs(Box, { marginTop: 1, flexDirection: "column", alignItems: "center", children: [_jsx(Text, { color: theme.value, children: `Authorization: Bearer ${launchToken}` }), _jsx(Text, { color: theme.warn, children: `⚠ keep this token safe — your agent needs it; it won't be shown again.` })] })) : null, _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: theme.value, children: "1 \u00B7 Connect your agent (READ):" }), _jsx(Text, { color: theme.dim, children: `   Claude Code   claude mcp add --transport http nodedex ${mcpUrl}` }), _jsx(Text, { color: theme.dim, children: `   Hermes        MCP server url → ${mcpUrl}` }), _jsx(Text, { color: theme.dim, children: `   Other hosts   any MCP client → that URL (Streamable HTTP)` })] }), _jsxs(Box, { marginTop: 1, flexDirection: "column", children: [_jsx(Text, { color: theme.value, children: "2 \u00B7 Wire CAPTURE \u2014 without it the graph stays empty:" }), _jsx(Text, { color: theme.dim, children: `   Hermes → automatic (watcher) · other hosts → README "capture"` })] }), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: theme.dim, children: "Copy-paste snippets for every host (incl. auth) saved to:" }) }), _jsx(Text, { color: theme.accent, children: "~/.nodedex/connect-snippets.md" }), _jsx(Text, { color: theme.accent, children: README_URL })] }), _jsx(Hint, { keys: [["Enter", "open dashboard"]] })] }));
+    }
+    // starting
+    return (_jsxs(Frame, { children: [_jsxs(Box, { children: [_jsx(Spinner, {}), _jsx(Text, { color: theme.value, children: ` ${status || "Starting…"}` })] }), error ? _jsx(Text, { color: theme.danger, children: `⚠ ${error}` }) : null] }));
+}