nlm-memory 0.4.0

package/dist/install/setup.js

@@ -0,0 +1,339 @@
+/**
+ * `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 { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+import { cancel, confirm, intro, isCancel, log, multiselect, outro, password, select, spinner, } from "@clack/prompts";
+import { connectClaudeCode } from "./claude-code.js";
+import { connectHermes } from "./hermes.js";
+import { codexBinaryAvailable, connectCodex, pluginScriptsDir } from "./codex.js";
+import { defaultDbPath as openCodeDefaultDbPath } from "../core/adapters/opencode.js";
+import { EMBEDDING_MODEL, embeddingModelPresent, installOllama, ollamaBinaryAvailable, ollamaServerRunning, pullEmbeddingModel, startOllamaServer, waitForOllamaServer, writeClassifierConfig, } from "./ollama.js";
+import { installClaudeCodeHooks } from "./claude-code.js";
+const OS = platform();
+function detectRuntimes() {
+    const claudeProjectsPath = process.env["NLM_CLAUDE_PROJECTS_PATH"]
+        ?? join(homedir(), ".claude", "projects");
+    const hermesPath = process.env["NLM_HERMES_SESSIONS_PATH"]
+        ?? join(homedir(), ".hermes", "sessions");
+    const piPath = process.env["PI_SESSIONS_PATH"]
+        ?? join(homedir(), ".pi", "agent", "sessions");
+    const openCodeDb = openCodeDefaultDbPath();
+    return [
+        {
+            id: "claude-code",
+            label: "Claude Code",
+            hint: existsSync(claudeProjectsPath) ? "detected" : "not found",
+            detected: existsSync(claudeProjectsPath),
+        },
+        {
+            id: "codex",
+            label: "Codex (OpenAI)",
+            hint: codexBinaryAvailable() ? "detected" : "not found — install: npm i -g @openai/codex",
+            detected: codexBinaryAvailable(),
+        },
+        {
+            id: "opencode",
+            label: "OpenCode (sst)",
+            hint: existsSync(openCodeDb) ? "detected" : "not found",
+            detected: existsSync(openCodeDb),
+        },
+        {
+            id: "hermes",
+            label: "Hermes",
+            hint: existsSync(hermesPath) ? "detected" : "not found",
+            detected: existsSync(hermesPath),
+        },
+        {
+            id: "pi",
+            label: "pi.dev",
+            hint: existsSync(piPath) ? "detected" : "not found",
+            detected: existsSync(piPath),
+        },
+    ];
+}
+export async function runSetup(opts) {
+    intro("NLM Memory — first-run setup");
+    // ── Step 1: runtime selection ─────────────────────────────────────────
+    const runtimes = detectRuntimes();
+    const detectedIds = runtimes.filter((r) => r.detected).map((r) => r.id);
+    const selected = await multiselect({
+        message: "Which AI coding runtimes do you use?",
+        options: runtimes.map((r) => ({ value: r.id, label: r.label, hint: r.hint })),
+        initialValues: detectedIds,
+        required: false,
+    });
+    if (isCancel(selected)) {
+        cancel("Setup cancelled.");
+        process.exit(0);
+    }
+    const chosen = selected;
+    // ── Step 2: Ollama preflight ──────────────────────────────────────────
+    if (!ollamaBinaryAvailable()) {
+        const installMsg = OS === "linux"
+            ? "Ollama not found. Install now? (runs the official install.sh as current user — see https://ollama.com/install.sh)"
+            : "Ollama not found. Install it now? (required for memory indexing)";
+        const doInstall = await confirm({ message: installMsg });
+        if (isCancel(doInstall)) {
+            cancel("Setup cancelled.");
+            process.exit(0);
+        }
+        if (doInstall) {
+            const is = spinner();
+            is.start("Installing Ollama");
+            const result = installOllama();
+            if (result.ok) {
+                is.stop("Ollama installed");
+            }
+            else {
+                is.stop("Ollama install failed");
+                log.warn(result.output);
+                log.warn("Install Ollama manually from https://ollama.com/download, then re-run `nlm setup`.");
+            }
+        }
+        else {
+            log.warn("Skipping Ollama install — memory indexing won't work until Ollama is running with nomic-embed-text.");
+        }
+    }
+    // Ensure server is running before attempting pull.
+    if (ollamaBinaryAvailable() && !ollamaServerRunning()) {
+        const ss = spinner();
+        ss.start("Starting Ollama server");
+        const result = startOllamaServer();
+        if (result.ok) {
+            ss.start("Waiting for Ollama server to accept connections");
+            const ready = await waitForOllamaServer(15, 1000);
+            if (ready) {
+                ss.stop("Ollama server ready");
+            }
+            else {
+                ss.stop("Ollama server started but not responding yet");
+                log.warn("If the model pull fails, wait a moment and run `ollama pull nomic-embed-text` manually.");
+            }
+        }
+        else {
+            ss.stop("Could not start Ollama server automatically");
+            log.warn(`Start it manually with \`ollama serve\`, then re-run \`nlm setup\`. (${result.output})`);
+        }
+    }
+    if (ollamaBinaryAvailable() && !embeddingModelPresent()) {
+        const doPull = await confirm({ message: `Pull the ${EMBEDDING_MODEL} embedding model now? (~274 MB, required for semantic recall)` });
+        if (isCancel(doPull)) {
+            cancel("Setup cancelled.");
+            process.exit(0);
+        }
+        if (doPull) {
+            const ps = spinner();
+            ps.start(`Pulling ${EMBEDDING_MODEL} (this may take a few minutes)`);
+            const result = pullEmbeddingModel();
+            if (result.ok) {
+                ps.stop(`${EMBEDDING_MODEL} ready`);
+            }
+            else {
+                ps.stop("Model pull failed");
+                log.warn(`Run \`ollama pull ${EMBEDDING_MODEL}\` manually to retry.`);
+            }
+        }
+        else {
+            log.warn(`Skipping model pull — run \`ollama pull ${EMBEDDING_MODEL}\` before using memory recall.`);
+        }
+    }
+    if (ollamaBinaryAvailable() && embeddingModelPresent()) {
+        log.success(`Ollama ready — ${EMBEDDING_MODEL} present`);
+    }
+    // ── Step 3: classifier API key ────────────────────────────────────────
+    const wantKey = await confirm({ message: "Add a classifier API key? (enables accurate session tagging; DeepSeek is ~$0.002/session)" });
+    if (isCancel(wantKey)) {
+        cancel("Setup cancelled.");
+        process.exit(0);
+    }
+    if (wantKey) {
+        const classifierChoice = await select({
+            message: "Which classifier?",
+            options: [
+                { value: "deepseek", label: "DeepSeek", hint: "recommended — fast, cheap, needs DEEPSEEK_API_KEY" },
+                { value: "ollama-offline", label: "Ollama (offline)", hint: "free, no API key, slower and less accurate" },
+            ],
+        });
+        if (isCancel(classifierChoice)) {
+            cancel("Setup cancelled.");
+            process.exit(0);
+        }
+        if (classifierChoice === "deepseek") {
+            const key = await password({ message: "DeepSeek API key (get one at platform.deepseek.com):" });
+            if (isCancel(key)) {
+                cancel("Setup cancelled.");
+                process.exit(0);
+            }
+            if (key && key.trim()) {
+                writeClassifierConfig("deepseek", key.trim());
+                log.success("DeepSeek API key saved to ~/.nlm/.env");
+            }
+            else {
+                log.warn("No key entered — set DEEPSEEK_API_KEY in ~/.nlm/.env later.");
+            }
+        }
+        else {
+            writeClassifierConfig("ollama-offline");
+            log.success("Classifier set to Ollama offline (saved to ~/.nlm/.env)");
+        }
+    }
+    // ── Step 4: migrations ────────────────────────────────────────────────
+    const ms = spinner();
+    ms.start("Running database migrations");
+    try {
+        const { SqliteSessionStore } = await import("../core/storage/sqlite-session-store.js");
+        const store = new SqliteSessionStore({ dbPath: opts.dbPath, migrationsDir: opts.migrationsDir });
+        store.close();
+        ms.stop("Database ready");
+    }
+    catch (e) {
+        ms.stop("Migration failed");
+        log.error(`${e instanceof Error ? e.message : String(e)}`);
+        process.exit(1);
+    }
+    // ── Step 5: daemon ────────────────────────────────────────────────────
+    if (OS === "darwin") {
+        const installDaemon = await confirm({ message: "Install macOS LaunchAgent (auto-start on login)?" });
+        if (isCancel(installDaemon)) {
+            cancel("Setup cancelled.");
+            process.exit(0);
+        }
+        if (installDaemon) {
+            const ds = spinner();
+            ds.start("Installing LaunchAgent");
+            try {
+                const uid = process.getuid?.();
+                if (uid === undefined)
+                    throw new Error("Could not determine UID");
+                mkdirSync(join(homedir(), ".nlm", "logs"), { recursive: true });
+                writeFileSync(opts.launchAgentPlist, opts.buildPlist(opts.nodeExecPath, opts.nlmBinPath), "utf8");
+                try {
+                    execFileSync("launchctl", ["bootout", `gui/${uid}`, opts.launchAgentLabel], { stdio: "ignore" });
+                }
+                catch { /* not loaded yet — expected */ }
+                execFileSync("launchctl", ["bootstrap", `gui/${uid}`, opts.launchAgentPlist]);
+                ds.stop("LaunchAgent installed — daemon running");
+            }
+            catch (e) {
+                ds.stop("LaunchAgent install failed");
+                log.error(`${e instanceof Error ? e.message : String(e)}`);
+                log.warn("Run `nlm install` manually later.");
+            }
+        }
+    }
+    else if (OS === "linux") {
+        log.info("Linux daemon: add `nlm start` to your init system to auto-start on boot.");
+        log.info("  systemd example:  sudo systemctl enable --now nlm  (after creating a unit file)");
+        log.info("  Quick start now:  nlm start &");
+    }
+    else if (OS === "win32") {
+        log.info("Windows daemon: run `nlm start` at login via Task Scheduler.");
+        log.info("  Or start manually: nlm start");
+    }
+    // ── Step 6: per-runtime configuration ────────────────────────────────
+    for (const id of chosen) {
+        switch (id) {
+            case "claude-code": {
+                // MCP config
+                const cs = spinner();
+                cs.start("Configuring Claude Code — MCP server");
+                try {
+                    const report = connectClaudeCode({ nlmBinPath: opts.nlmBinPath, nodeExecPath: opts.nodeExecPath });
+                    cs.stop(`MCP server ${report.alreadyPresent ? "updated" : "written"} → ${report.mcpConfigPath}`);
+                }
+                catch (e) {
+                    cs.stop("MCP config write failed");
+                    log.error(`${e instanceof Error ? e.message : String(e)}`);
+                }
+                // Hooks — Claude Code hooks are process hooks (settings.json), not
+                // OS-level scripts, so they work on all platforms where Claude Code runs.
+                const hs = spinner();
+                hs.start("Configuring Claude Code — session hooks");
+                const hookLogPath = process.env["NLM_HOOK_LOG"] ?? join(homedir(), ".nlm", "hook-log.jsonl");
+                const hookResult = installClaudeCodeHooks({
+                    nodeExecPath: opts.nodeExecPath,
+                    hooks: opts.allHooks,
+                    settingsPath: opts.claudeSettingsPath,
+                    hookLogPath,
+                    addHook: opts.addHook,
+                    removeHook: opts.removeHook,
+                    buildHookCommand: opts.buildHookCommand,
+                    smokeTestHookCommand: opts.smokeTestHookCommand,
+                });
+                if (hookResult.ok) {
+                    hs.stop(`${hookResult.count} hooks installed → ${opts.claudeSettingsPath}`);
+                }
+                else {
+                    hs.stop(`Hook install failed (${hookResult.failedLabel ?? "unknown"})`);
+                    if (hookResult.errorMessage)
+                        log.error(hookResult.errorMessage);
+                    log.warn("Run `nlm hook install` manually after checking your Node path.");
+                }
+                break;
+            }
+            case "codex": {
+                if (!codexBinaryAvailable()) {
+                    log.warn("Codex binary not found — install with `npm i -g @openai/codex`, then run `nlm connect codex`.");
+                    break;
+                }
+                const cs = spinner();
+                cs.start("Connecting Codex");
+                try {
+                    const report = connectCodex({ source: "pbmagnet4/nlm-memory-ts" }, pluginScriptsDir(opts.repoRoot));
+                    if (report.marketplaceAdd?.status !== 0 || report.pluginAdd?.status !== 0) {
+                        cs.stop("Codex connect had errors — run `nlm connect codex` manually to retry");
+                    }
+                    else {
+                        cs.stop("Codex marketplace + plugin registered");
+                    }
+                }
+                catch (e) {
+                    cs.stop("Codex connect failed");
+                    log.error(`${e instanceof Error ? e.message : String(e)}`);
+                }
+                break;
+            }
+            case "opencode":
+                log.success("OpenCode: session scanning enabled (passive — no extra config needed)");
+                break;
+            case "hermes": {
+                const hs = spinner();
+                hs.start("Configuring Hermes");
+                try {
+                    const report = connectHermes({ nlmBinPath: opts.nlmBinPath, nodeExecPath: opts.nodeExecPath });
+                    hs.stop(`MCP server ${report.alreadyPresent ? "updated" : "written"} → ${report.configPath}`);
+                }
+                catch (e) {
+                    hs.stop("Hermes config write failed");
+                    log.error(`${e instanceof Error ? e.message : String(e)}`);
+                    log.warn("Run `nlm connect hermes` manually after checking ~/.hermes/config.yaml.");
+                }
+                break;
+            }
+            case "pi":
+                log.success("pi.dev: session scanning enabled (passive — no extra config needed)");
+                break;
+        }
+    }
+    // ── Summary ───────────────────────────────────────────────────────────
+    const needsRestart = [];
+    if (chosen.includes("claude-code"))
+        needsRestart.push("Claude Code");
+    if (chosen.includes("hermes"))
+        needsRestart.push("Hermes");
+    outro(needsRestart.length > 0
+        ? `Done! Restart ${needsRestart.join(" and ")} for the MCP server to activate, then start a session — memory will follow.`
+        : "Done! Start a session in any configured runtime and NLM will begin indexing automatically.");
+}
+//# sourceMappingURL=setup.js.map

package/dist/install/setup.js.map

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

package/dist/llm/classifier-box.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ClassifierBox — a mutable LLMClient wrapper holding the active classifier
+ * client. The scheduler reads `inner` on each tick, so a runtime swap takes
+ * effect on the next session ingest without restarting the daemon.
+ *
+ * Only `classify()` is delegated. `embed()` throws — embeddings are wired
+ * separately through the dedicated Ollama embedder; the classifier slot is
+ * for transcript classification only.
+ */
+import type { ClassifyResult, EmbedResult, EmbeddingKind, LLMClient } from "../ports/llm-client.js";
+export type ClassifierProvider = "deepseek" | "ollama";
+export interface ClassifierBoxOptions {
+    readonly provider: ClassifierProvider;
+    readonly model: string;
+    readonly ollamaUrl?: string;
+}
+export declare class ClassifierBox implements LLMClient {
+    private inner;
+    private providerName;
+    private modelName;
+    private readonly ollamaUrl;
+    constructor(opts: ClassifierBoxOptions);
+    get provider(): ClassifierProvider;
+    get model(): string;
+    swap(provider: ClassifierProvider, model: string): void;
+    embed(_text: string, _kind: EmbeddingKind): Promise<EmbedResult>;
+    classify(transcript: string): Promise<ClassifyResult>;
+    private construct;
+}

package/dist/llm/classifier-box.js

@@ -0,0 +1,43 @@
+/**
+ * ClassifierBox — a mutable LLMClient wrapper holding the active classifier
+ * client. The scheduler reads `inner` on each tick, so a runtime swap takes
+ * effect on the next session ingest without restarting the daemon.
+ *
+ * Only `classify()` is delegated. `embed()` throws — embeddings are wired
+ * separately through the dedicated Ollama embedder; the classifier slot is
+ * for transcript classification only.
+ */
+import { DeepSeekClient } from "./deepseek-client.js";
+import { OllamaClient } from "./ollama-client.js";
+export class ClassifierBox {
+    inner;
+    providerName;
+    modelName;
+    ollamaUrl;
+    constructor(opts) {
+        this.providerName = opts.provider;
+        this.modelName = opts.model;
+        this.ollamaUrl = opts.ollamaUrl ?? "http://localhost:11434";
+        this.inner = this.construct(opts.provider, opts.model);
+    }
+    get provider() { return this.providerName; }
+    get model() { return this.modelName; }
+    swap(provider, model) {
+        this.inner = this.construct(provider, model);
+        this.providerName = provider;
+        this.modelName = model;
+    }
+    embed(_text, _kind) {
+        throw new Error("ClassifierBox.embed is not supported — wire OllamaClient as the embedder.");
+    }
+    classify(transcript) {
+        return this.inner.classify(transcript);
+    }
+    construct(provider, model) {
+        if (provider === "ollama") {
+            return new OllamaClient({ baseUrl: this.ollamaUrl, classifyModel: model });
+        }
+        return new DeepSeekClient({ classifyModel: model });
+    }
+}
+//# sourceMappingURL=classifier-box.js.map

package/dist/llm/classifier-box.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier-box.js","sourceRoot":"","sources":["../../src/llm/classifier-box.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUlD,MAAM,OAAO,aAAa;IAChB,KAAK,CAAY;IACjB,YAAY,CAAqB;IACjC,SAAS,CAAS;IACT,SAAS,CAAS;IAEnC,YAAY,IAA0B;QACpC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,wBAAwB,CAAC;QAC5D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,QAAQ,KAAyB,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAChE,IAAI,KAAK,KAAa,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAE9C,IAAI,CAAC,QAA4B,EAAE,KAAa;QAC9C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,KAAa,EAAE,KAAoB;QACvC,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC/F,CAAC;IAED,QAAQ,CAAC,UAAkB;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACzC,CAAC;IAEO,SAAS,CAAC,QAA4B,EAAE,KAAa;QAC3D,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC1B,OAAO,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,IAAI,cAAc,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;CACF"}

package/dist/llm/deepseek-client.d.ts

@@ -0,0 +1,40 @@
+/**
+ * DeepSeekClient — LLMClient backed by DeepSeek's OpenAI-compatible chat API.
+ *
+ * Use case (per Python notes confirmed 2026-05-07 / 2026-05-13):
+ *   • v4-flash handles inputs up to ~60K chars reliably; we cap at 30K to
+ *     stay well inside the deterministic zone.
+ *   • ~$0.002/session at typical sizes — full backfill of ~1,200 sessions
+ *     ≈ $2.50.
+ *   • Strong extraction quality (12+ entities, accurate decisions,
+ *     0.9 confidence) where phi4-mini struggles or times out.
+ *
+ * Same prompt module as OllamaClient — only the transport differs. Same
+ * error semantics: LLMUnreachableError for network/HTTP, ClassifierSchemaError
+ * for unparseable / shape-wrong output. Reads DEEPSEEK_API_KEY at construct
+ * time unless an explicit key is passed.
+ *
+ * Embedding is not supported by DeepSeek's API — `embed()` throws. Wire a
+ * separate embedder (OllamaClient) for semantic recall.
+ */
+import type { ClassifyResult, EmbedResult, EmbeddingKind, LLMClient } from "../ports/llm-client.js";
+export type FetchImpl = typeof fetch;
+export interface DeepSeekClientOptions {
+    readonly apiKey?: string;
+    readonly baseUrl?: string;
+    readonly classifyModel?: string;
+    readonly classifyTimeoutMs?: number;
+    readonly maxTranscriptChars?: number;
+    readonly fetchImpl?: FetchImpl;
+}
+export declare class DeepSeekClient implements LLMClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly classifyModel;
+    private readonly classifyTimeoutMs;
+    private readonly maxTranscriptChars;
+    private readonly fetchImpl;
+    constructor(opts?: DeepSeekClientOptions);
+    embed(_text: string, _kind: EmbeddingKind): Promise<EmbedResult>;
+    classify(transcript: string, priorContext?: string): Promise<ClassifyResult>;
+}

package/dist/llm/deepseek-client.js

@@ -0,0 +1,114 @@
+/**
+ * DeepSeekClient — LLMClient backed by DeepSeek's OpenAI-compatible chat API.
+ *
+ * Use case (per Python notes confirmed 2026-05-07 / 2026-05-13):
+ *   • v4-flash handles inputs up to ~60K chars reliably; we cap at 30K to
+ *     stay well inside the deterministic zone.
+ *   • ~$0.002/session at typical sizes — full backfill of ~1,200 sessions
+ *     ≈ $2.50.
+ *   • Strong extraction quality (12+ entities, accurate decisions,
+ *     0.9 confidence) where phi4-mini struggles or times out.
+ *
+ * Same prompt module as OllamaClient — only the transport differs. Same
+ * error semantics: LLMUnreachableError for network/HTTP, ClassifierSchemaError
+ * for unparseable / shape-wrong output. Reads DEEPSEEK_API_KEY at construct
+ * time unless an explicit key is passed.
+ *
+ * Embedding is not supported by DeepSeek's API — `embed()` throws. Wire a
+ * separate embedder (OllamaClient) for semantic recall.
+ */
+import { LLMUnreachableError } from "../ports/llm-client.js";
+import { CLASSIFIER_SYSTEM_PROMPT, buildUserPrompt, coerceClassifyResult, stripJsonFences, validateClassifierJson, } from "../core/classifier/prompt.js";
+import { ClassifierSchemaError } from "./ollama-client.js";
+export class DeepSeekClient {
+    apiKey;
+    baseUrl;
+    classifyModel;
+    classifyTimeoutMs;
+    maxTranscriptChars;
+    fetchImpl;
+    constructor(opts = {}) {
+        const key = opts.apiKey ?? process.env["DEEPSEEK_API_KEY"];
+        if (!key) {
+            throw new Error("DEEPSEEK_API_KEY not set. Export it, place it in ~/.nlm/.env, or pass apiKey explicitly.");
+        }
+        this.apiKey = key;
+        this.baseUrl = (opts.baseUrl ?? "https://api.deepseek.com/v1").replace(/\/+$/, "");
+        this.classifyModel = opts.classifyModel ?? "deepseek-v4-flash";
+        this.classifyTimeoutMs = opts.classifyTimeoutMs ?? 180_000;
+        this.maxTranscriptChars = opts.maxTranscriptChars ?? 30_000;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+    }
+    async embed(_text, _kind) {
+        throw new Error("DeepSeekClient.embed not supported — DeepSeek's API has no embeddings endpoint. Wire OllamaClient for embeddings.");
+    }
+    async classify(transcript, priorContext = "") {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.classifyTimeoutMs);
+        try {
+            // DeepSeek's reliable zone is ≤30K, narrower than the prompt module's
+            // 15K default. We pre-truncate to our wider cap to feed the model more
+            // context than Ollama can handle, then buildUserPrompt's own truncation
+            // is a no-op.
+            const sized = transcript.length <= this.maxTranscriptChars
+                ? transcript
+                : transcript.slice(0, this.maxTranscriptChars / 2 - 40) +
+                    "\n\n[... transcript truncated; below is the closing portion ...]\n\n" +
+                    transcript.slice(transcript.length - this.maxTranscriptChars / 2 + 40);
+            const userPrompt = buildUserPrompt(sized, priorContext);
+            const res = await this.fetchImpl(`${this.baseUrl}/chat/completions`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.apiKey}`,
+                },
+                body: JSON.stringify({
+                    model: this.classifyModel,
+                    messages: [
+                        { role: "system", content: CLASSIFIER_SYSTEM_PROMPT },
+                        { role: "user", content: userPrompt },
+                    ],
+                    response_format: { type: "json_object" },
+                    temperature: 0.1,
+                    // 8192 covers reasoning + JSON output. deepseek-v4-flash is a
+                    // reasoning model — its hidden chain-of-thought counts against
+                    // max_tokens but never reaches `content`. At 1024 the reasoning
+                    // consumed the entire budget and the JSON output came back empty
+                    // (finish_reason: length, content: ""). Backfill verified ~72% of
+                    // real claude-code sessions hit that mode at 1024. Real-world
+                    // observed reasoning_tokens: ~900-1100; JSON body adds 200-1000
+                    // depending on facts/entity counts. 8192 leaves headroom.
+                    max_tokens: 8192,
+                    stream: false,
+                }),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                throw new LLMUnreachableError("deepseek", `status ${res.status}: ${await res.text().catch(() => "")}`);
+            }
+            const data = (await res.json());
+            const rawContent = data.choices?.[0]?.message?.content?.trim() ?? "";
+            const content = stripJsonFences(rawContent);
+            let parsed;
+            try {
+                parsed = JSON.parse(content);
+            }
+            catch {
+                throw new ClassifierSchemaError("deepseek returned non-JSON content");
+            }
+            if (!validateClassifierJson(parsed)) {
+                throw new ClassifierSchemaError("deepseek response missing required keys");
+            }
+            return coerceClassifyResult(parsed);
+        }
+        catch (e) {
+            if (e instanceof LLMUnreachableError || e instanceof ClassifierSchemaError)
+                throw e;
+            throw new LLMUnreachableError("deepseek", e);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=deepseek-client.js.map

package/dist/llm/deepseek-client.js.map

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

package/dist/llm/env-autoload.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Mirror of `classifier.autoload_env` from the Python daemon. Reads KEY=VALUE
+ * pairs from a small list of likely .env locations into process.env. Existing
+ * env vars are NOT overridden.
+ *
+ * Returns the list of paths actually loaded. Safe to call multiple times.
+ */
+export declare function autoloadEnv(extraPaths?: ReadonlyArray<string>): string[];