nlm-memory 0.4.0

package/dist/install/hermes-agent.d.ts

@@ -0,0 +1,35 @@
+/**
+ * `nlm connect hermes-agent` / `nlm disconnect hermes-agent` — installs the
+ * nlm-memory plugin into NousResearch Hermes Agent's plugin directory and
+ * optionally enables it via the `hermes` binary.
+ *
+ * The plugin lives in plugin-hermes-agent/ at the repo root. `connect`
+ * copies it to ~/.hermes/plugins/nlm-memory/ (flat layout, one category
+ * level max per Hermes plugin discovery rules). `disconnect` removes that
+ * directory.
+ *
+ * MCP server wiring (the [mcp_servers.nlm-memory] block in
+ * ~/.hermes/config.yaml) is handled separately by `nlm connect hermes`.
+ */
+export interface ConnectHermesAgentOptions {
+    readonly pluginSrcDir: string;
+    readonly dryRun?: boolean;
+    readonly enableViaCliIfAvailable?: boolean;
+}
+export interface ConnectHermesAgentReport {
+    readonly destDir: string;
+    readonly copied: boolean;
+    readonly alreadyPresent: boolean;
+    readonly enabledViaCli: boolean;
+    readonly dryRun: boolean;
+}
+export interface DisconnectHermesAgentReport {
+    readonly destDir: string;
+    readonly removed: boolean;
+    readonly dryRun: boolean;
+}
+export declare function hermesAgentPluginDir(): string;
+export declare function connectHermesAgent(opts: ConnectHermesAgentOptions): ConnectHermesAgentReport;
+export declare function disconnectHermesAgent(opts?: {
+    dryRun?: boolean;
+}): DisconnectHermesAgentReport;

package/dist/install/hermes-agent.js

@@ -0,0 +1,48 @@
+/**
+ * `nlm connect hermes-agent` / `nlm disconnect hermes-agent` — installs the
+ * nlm-memory plugin into NousResearch Hermes Agent's plugin directory and
+ * optionally enables it via the `hermes` binary.
+ *
+ * The plugin lives in plugin-hermes-agent/ at the repo root. `connect`
+ * copies it to ~/.hermes/plugins/nlm-memory/ (flat layout, one category
+ * level max per Hermes plugin discovery rules). `disconnect` removes that
+ * directory.
+ *
+ * MCP server wiring (the [mcp_servers.nlm-memory] block in
+ * ~/.hermes/config.yaml) is handled separately by `nlm connect hermes`.
+ */
+import { cpSync, existsSync, mkdirSync, rmSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { spawnSync } from "node:child_process";
+export function hermesAgentPluginDir() {
+    return process.env["NLM_HERMES_PLUGIN_DIR"] ?? join(homedir(), ".hermes", "plugins", "nlm-memory");
+}
+export function connectHermesAgent(opts) {
+    const destDir = hermesAgentPluginDir();
+    const alreadyPresent = existsSync(destDir);
+    if (!opts.dryRun) {
+        mkdirSync(dirname(destDir), { recursive: true });
+        cpSync(opts.pluginSrcDir, destDir, { recursive: true });
+        let enabledViaCli = false;
+        if (opts.enableViaCliIfAvailable !== false) {
+            const result = spawnSync("hermes", ["plugins", "enable", "nlm-memory"], {
+                encoding: "utf8",
+                timeout: 10_000,
+            });
+            enabledViaCli = result.status === 0;
+        }
+        return { destDir, copied: true, alreadyPresent, enabledViaCli, dryRun: false };
+    }
+    return { destDir, copied: false, alreadyPresent, enabledViaCli: false, dryRun: true };
+}
+export function disconnectHermesAgent(opts) {
+    const destDir = hermesAgentPluginDir();
+    const present = existsSync(destDir);
+    if (!opts?.dryRun && present) {
+        rmSync(destDir, { recursive: true, force: true });
+        return { destDir, removed: true, dryRun: false };
+    }
+    return { destDir, removed: false, dryRun: opts?.dryRun ?? false };
+}
+//# sourceMappingURL=hermes-agent.js.map

package/dist/install/hermes-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes-agent.js","sourceRoot":"","sources":["../../src/install/hermes-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAsB/C,MAAM,UAAU,oBAAoB;IAClC,OAAO,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC;AACrG,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAA+B;IAChE,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAC;IACvC,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAExD,IAAI,aAAa,GAAG,KAAK,CAAC;QAC1B,IAAI,IAAI,CAAC,uBAAuB,KAAK,KAAK,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,EAAE;gBACtE,QAAQ,EAAE,MAAM;gBAChB,OAAO,EAAE,MAAM;aAChB,CAAC,CAAC;YACH,aAAa,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACjF,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAA2B;IAC/D,MAAM,OAAO,GAAG,oBAAoB,EAAE,CAAC;IACvC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAEpC,IAAI,CAAC,IAAI,EAAE,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACnD,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC;AACpE,CAAC"}

package/dist/install/hermes.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `nlm connect hermes` / `nlm disconnect hermes` — writes the nlm-memory
+ * MCP server entry into ~/.hermes/config.yaml.
+ *
+ * Uses yaml's Document API (parseDocument / doc.setIn / doc.toString) to
+ * preserve any comments the user has written in their config file. Round-
+ * tripping through parse+stringify would silently destroy comments.
+ */
+export interface ConnectHermesOptions {
+    readonly nlmBinPath: string;
+    readonly nodeExecPath: string;
+    readonly dryRun?: boolean;
+}
+export interface ConnectHermesReport {
+    readonly configPath: string;
+    readonly alreadyPresent: boolean;
+    readonly written: boolean;
+    readonly dryRun: boolean;
+}
+export interface DisconnectHermesReport {
+    readonly configPath: string;
+    readonly removed: boolean;
+    readonly dryRun: boolean;
+}
+export declare function hermesConfigPath(): string;
+export declare function connectHermes(opts: ConnectHermesOptions): ConnectHermesReport;
+export declare function disconnectHermes(opts?: {
+    dryRun?: boolean;
+}): DisconnectHermesReport;

package/dist/install/hermes.js

@@ -0,0 +1,52 @@
+/**
+ * `nlm connect hermes` / `nlm disconnect hermes` — writes the nlm-memory
+ * MCP server entry into ~/.hermes/config.yaml.
+ *
+ * Uses yaml's Document API (parseDocument / doc.setIn / doc.toString) to
+ * preserve any comments the user has written in their config file. Round-
+ * tripping through parse+stringify would silently destroy comments.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { Document as YamlDocument, parseDocument as parseYamlDocument } from "yaml";
+export function hermesConfigPath() {
+    return process.env["NLM_HERMES_CONFIG"] ?? join(homedir(), ".hermes", "config.yaml");
+}
+function readDocument(path) {
+    if (!existsSync(path))
+        return new YamlDocument();
+    try {
+        return parseYamlDocument(readFileSync(path, "utf8"));
+    }
+    catch {
+        throw new Error(`${path} is not valid YAML. Fix or remove it, then re-run \`nlm connect hermes\`.`);
+    }
+}
+export function connectHermes(opts) {
+    const configPath = hermesConfigPath();
+    const doc = readDocument(configPath);
+    const alreadyPresent = doc.getIn(["mcp_servers", "nlm-memory"]) !== undefined;
+    if (!opts.dryRun) {
+        doc.setIn(["mcp_servers", "nlm-memory"], {
+            command: opts.nodeExecPath,
+            args: [opts.nlmBinPath, "mcp"],
+        });
+        mkdirSync(dirname(configPath), { recursive: true });
+        writeFileSync(configPath, doc.toString(), "utf8");
+    }
+    return { configPath, alreadyPresent, written: !opts.dryRun, dryRun: opts.dryRun ?? false };
+}
+export function disconnectHermes(opts) {
+    const configPath = hermesConfigPath();
+    const doc = readDocument(configPath);
+    if (doc.getIn(["mcp_servers", "nlm-memory"]) === undefined) {
+        return { configPath, removed: false, dryRun: opts?.dryRun ?? false };
+    }
+    if (!opts?.dryRun) {
+        doc.deleteIn(["mcp_servers", "nlm-memory"]);
+        writeFileSync(configPath, doc.toString(), "utf8");
+    }
+    return { configPath, removed: true, dryRun: opts?.dryRun ?? false };
+}
+//# sourceMappingURL=hermes.js.map

package/dist/install/hermes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hermes.js","sourceRoot":"","sources":["../../src/install/hermes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAqBpF,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;AACvF,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,YAAY,EAAE,CAAC;IACjD,IAAI,CAAC;QACH,OAAO,iBAAiB,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,2EAA2E,CAAC,CAAC;IACtG,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAA0B;IACtD,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,cAAc,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,KAAK,SAAS,CAAC;IAE9E,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACjB,GAAG,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,YAAY,CAAC,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,IAAI,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC;SAC/B,CAAC,CAAC;QACH,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,aAAa,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;AAC7F,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAA2B;IAC1D,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAErC,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC3D,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC;IACvE,CAAC;IAED,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAClB,GAAG,CAAC,QAAQ,CAAC,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;QAC5C,aAAa,CAAC,UAAU,EAAE,GAAG,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,EAAE,CAAC;AACtE,CAAC"}

package/dist/install/ollama.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Ollama preflight helpers for `nlm setup`.
+ *
+ * Three cases handled:
+ *   1. Ollama not installed     → install it
+ *   2. Ollama installed, server not responding → start the server
+ *   3. Embedding model missing  → pull it
+ *
+ * Platform support:
+ *   macOS  — brew install / Ollama.app / brew services / open -a
+ *   Linux  — official install.sh / systemctl / detached spawn
+ *   Windows — winget install / detached spawn
+ */
+export declare const EMBEDDING_MODEL = "nomic-embed-text";
+export interface OllamaResult {
+    readonly ok: boolean;
+    readonly output: string;
+}
+export declare function ollamaBinaryAvailable(): boolean;
+/** Returns true if the Ollama server is accepting API requests. */
+export declare function ollamaServerRunning(): boolean;
+/** Returns true if nomic-embed-text is present in `ollama list`. */
+export declare function embeddingModelPresent(): boolean;
+/**
+ * Install Ollama using the best available method for the current platform.
+ * Returns { ok: false } if no automated path exists — caller shows manual instructions.
+ */
+export declare function installOllama(): OllamaResult;
+/**
+ * Start the Ollama server in the background.
+ *
+ * Platform preference:
+ *   macOS + brew    → brew services start ollama
+ *   macOS + app     → open -a Ollama
+ *   Linux + systemd → systemctl start ollama (needs sudo; falls back to spawn)
+ *   All others      → detached spawn of `ollama serve`
+ */
+export declare function startOllamaServer(): OllamaResult;
+/**
+ * Poll until the Ollama server is accepting requests or maxAttempts is reached.
+ * Returns true if the server came up, false on timeout.
+ */
+export declare function waitForOllamaServer(maxAttempts?: number, intervalMs?: number): Promise<boolean>;
+/**
+ * Pull the embedding model. Blocks until complete (~1–3 min on first run, a
+ * few seconds on subsequent runs). The caller shows a spinner during this call.
+ */
+export declare function pullEmbeddingModel(): OllamaResult;
+export type ClassifierChoice = "deepseek" | "ollama-offline";
+/**
+ * Write classifier config to ~/.nlm/.env. Merges into the existing file —
+ * only the lines we manage are updated; anything the user added by hand stays.
+ */
+export declare function writeClassifierConfig(choice: ClassifierChoice, apiKey?: string): void;

package/dist/install/ollama.js

@@ -0,0 +1,178 @@
+/**
+ * Ollama preflight helpers for `nlm setup`.
+ *
+ * Three cases handled:
+ *   1. Ollama not installed     → install it
+ *   2. Ollama installed, server not responding → start the server
+ *   3. Embedding model missing  → pull it
+ *
+ * Platform support:
+ *   macOS  — brew install / Ollama.app / brew services / open -a
+ *   Linux  — official install.sh / systemctl / detached spawn
+ *   Windows — winget install / detached spawn
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+import { spawnSync, spawn } from "node:child_process";
+export const EMBEDDING_MODEL = "nomic-embed-text";
+const OS = platform();
+// ── Detection ─────────────────────────────────────────────────────────────
+export function ollamaBinaryAvailable() {
+    const r = spawnSync("ollama", ["--version"], { encoding: "utf8" });
+    return r.status === 0;
+}
+/** Returns true if the Ollama server is accepting API requests. */
+export function ollamaServerRunning() {
+    const r = spawnSync("ollama", ["list"], { encoding: "utf8" });
+    return r.status === 0;
+}
+/** Returns true if nomic-embed-text is present in `ollama list`. */
+export function embeddingModelPresent() {
+    const r = spawnSync("ollama", ["list"], { encoding: "utf8" });
+    if (r.status !== 0)
+        return false;
+    return r.stdout.includes(EMBEDDING_MODEL);
+}
+function brewAvailable() {
+    return spawnSync("brew", ["--version"], { encoding: "utf8" }).status === 0;
+}
+function ollamaAppInstalled() {
+    return existsSync("/Applications/Ollama.app");
+}
+function wingetAvailable() {
+    return spawnSync("winget", ["--version"], { encoding: "utf8", shell: true }).status === 0;
+}
+function systemctlAvailable() {
+    return spawnSync("systemctl", ["--version"], { encoding: "utf8" }).status === 0;
+}
+// ── Install ───────────────────────────────────────────────────────────────
+/**
+ * Install Ollama using the best available method for the current platform.
+ * Returns { ok: false } if no automated path exists — caller shows manual instructions.
+ */
+export function installOllama() {
+    if (OS === "darwin") {
+        if (brewAvailable()) {
+            const r = spawnSync("brew", ["install", "ollama"], { encoding: "utf8" });
+            return { ok: r.status === 0, output: (r.stdout + r.stderr).trim() };
+        }
+        return {
+            ok: false,
+            output: "Homebrew not found. Download Ollama from https://ollama.com/download and re-run setup.",
+        };
+    }
+    if (OS === "linux") {
+        // Runs: curl -fsSL https://ollama.com/install.sh | sh
+        // The official Ollama installer — sets up the binary and a systemd service.
+        // Requires sudo internally and may modify /etc/systemd/. The caller is
+        // responsible for confirming this with the user before calling.
+        const r = spawnSync("sh", ["-c", "curl -fsSL --proto '=https' https://ollama.com/install.sh | sh"], {
+            encoding: "utf8",
+            timeout: 120_000,
+        });
+        return { ok: r.status === 0, output: (r.stdout + r.stderr).trim() };
+    }
+    if (OS === "win32") {
+        if (wingetAvailable()) {
+            const r = spawnSync("winget", ["install", "Ollama.Ollama"], { encoding: "utf8", shell: true });
+            return { ok: r.status === 0, output: (r.stdout + r.stderr).trim() };
+        }
+        return {
+            ok: false,
+            output: "Download Ollama from https://ollama.com/download and re-run setup.",
+        };
+    }
+    return { ok: false, output: `Unsupported platform: ${OS}. Install from https://ollama.com/download.` };
+}
+// ── Server start ──────────────────────────────────────────────────────────
+/**
+ * Start the Ollama server in the background.
+ *
+ * Platform preference:
+ *   macOS + brew    → brew services start ollama
+ *   macOS + app     → open -a Ollama
+ *   Linux + systemd → systemctl start ollama (needs sudo; falls back to spawn)
+ *   All others      → detached spawn of `ollama serve`
+ */
+export function startOllamaServer() {
+    if (OS === "darwin") {
+        if (brewAvailable()) {
+            const r = spawnSync("brew", ["services", "start", "ollama"], { encoding: "utf8" });
+            if (r.status === 0)
+                return { ok: true, output: "Started via brew services" };
+        }
+        if (ollamaAppInstalled()) {
+            const r = spawnSync("open", ["-a", "Ollama"], { encoding: "utf8" });
+            if (r.status === 0)
+                return { ok: true, output: "Started via Ollama.app" };
+        }
+    }
+    if (OS === "linux" && systemctlAvailable()) {
+        // systemctl requires root — try without sudo first (works in user sessions
+        // where the service is installed under the current user), fall through on failure.
+        const r = spawnSync("systemctl", ["start", "ollama"], { encoding: "utf8" });
+        if (r.status === 0)
+            return { ok: true, output: "Started via systemctl" };
+    }
+    // Universal fallback: detach `ollama serve`.
+    try {
+        mkdirSync(join(homedir(), ".nlm", "logs"), { recursive: true });
+        const child = spawn("ollama", ["serve"], {
+            detached: true,
+            stdio: "ignore",
+        });
+        child.unref();
+        return { ok: true, output: `ollama serve started (pid ${child.pid})` };
+    }
+    catch (e) {
+        return { ok: false, output: e instanceof Error ? e.message : String(e) };
+    }
+}
+/**
+ * Poll until the Ollama server is accepting requests or maxAttempts is reached.
+ * Returns true if the server came up, false on timeout.
+ */
+export async function waitForOllamaServer(maxAttempts = 15, intervalMs = 1000) {
+    for (let i = 0; i < maxAttempts; i++) {
+        if (ollamaServerRunning())
+            return true;
+        await new Promise((res) => setTimeout(res, intervalMs));
+    }
+    return false;
+}
+// ── Model pull ────────────────────────────────────────────────────────────
+/**
+ * Pull the embedding model. Blocks until complete (~1–3 min on first run, a
+ * few seconds on subsequent runs). The caller shows a spinner during this call.
+ */
+export function pullEmbeddingModel() {
+    // Give the server a moment to accept connections if it was just started.
+    const r = spawnSync("ollama", ["pull", EMBEDDING_MODEL], { encoding: "utf8" });
+    return { ok: r.status === 0, output: (r.stdout + r.stderr).trim() };
+}
+/**
+ * Write classifier config to ~/.nlm/.env. Merges into the existing file —
+ * only the lines we manage are updated; anything the user added by hand stays.
+ */
+export function writeClassifierConfig(choice, apiKey) {
+    const envPath = join(homedir(), ".nlm", ".env");
+    mkdirSync(join(homedir(), ".nlm"), { recursive: true });
+    const existing = existsSync(envPath) ? readFileSync(envPath, "utf8") : "";
+    const kept = existing
+        .split("\n")
+        .filter((l) => !l.startsWith("DEEPSEEK_API_KEY=") && !l.startsWith("NLM_CLASSIFIER="))
+        .join("\n")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+    const additions = [];
+    if (choice === "deepseek" && apiKey) {
+        // Strip newlines that clipboard paste can introduce.
+        const sanitized = apiKey.replace(/[\r\n]/g, "").trim();
+        additions.push(`DEEPSEEK_API_KEY=${sanitized}`);
+    }
+    if (choice === "ollama-offline")
+        additions.push("NLM_CLASSIFIER=ollama");
+    writeFileSync(envPath, [kept, ...additions].filter(Boolean).join("\n") + "\n", "utf8");
+}
+//# sourceMappingURL=ollama.js.map

package/dist/install/ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama.js","sourceRoot":"","sources":["../../src/install/ollama.ts"],"names":[],"mappings":"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"}

package/dist/install/setup.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `nlm setup` — interactive first-run wizard.
+ *
+ * Step order:
+ *   1. Select runtimes
+ *   2. Ollama preflight (install → start server → pull embedding model)
+ *   3. Classifier API key
+ *   4. DB migrations
+ *   5. Daemon (LaunchAgent on macOS / systemd hint on Linux / Task Scheduler hint on Windows)
+ *   6. Per-runtime MCP + hook wiring
+ */
+import type { ClaudeHookEvent } from "../core/hook/claude-settings.js";
+export interface SetupOptions {
+    readonly nlmBinPath: string;
+    readonly nodeExecPath: string;
+    readonly migrationsDir: string;
+    readonly repoRoot: string;
+    readonly dbPath: string;
+    readonly launchAgentLabel: string;
+    readonly launchAgentPlist: string;
+    readonly buildPlist: (nodeExec: string, binPath: string) => string;
+    readonly claudeSettingsPath: string;
+    readonly allHooks: ReadonlyArray<{
+        event: ClaudeHookEvent;
+        script: string;
+        label: string;
+    }>;
+    readonly addHook: (path: string, command: string, event?: ClaudeHookEvent) => void;
+    readonly removeHook: (path: string, event?: ClaudeHookEvent | "*") => void;
+    readonly buildHookCommand: (nodeExec: string, script: string, mode: "shadow" | "live") => string;
+    readonly smokeTestHookCommand: (command: string, logPath: string) => {
+        ok: boolean;
+        reason?: string;
+        stderr?: string;
+    };
+}
+export declare function runSetup(opts: SetupOptions): Promise<void>;