nlm-memory 0.4.0

package/dist/llm/env-autoload.js

@@ -0,0 +1,54 @@
+/**
+ * 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.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+const DEFAULT_SEARCH_PATHS = [
+    "~/.nlm/.env",
+    "./.env",
+    "../.env",
+    "../../.env",
+];
+function expandHome(p) {
+    if (p.startsWith("~/"))
+        return resolve(homedir(), p.slice(2));
+    return p;
+}
+export function autoloadEnv(extraPaths = []) {
+    const loaded = [];
+    const paths = [...DEFAULT_SEARCH_PATHS, ...extraPaths];
+    for (const raw of paths) {
+        const path = expandHome(raw);
+        if (!existsSync(path))
+            continue;
+        try {
+            const content = readFileSync(path, "utf8");
+            for (const line of content.split("\n")) {
+                const trimmed = line.trim();
+                if (!trimmed || trimmed.startsWith("#") || !trimmed.includes("="))
+                    continue;
+                const eq = trimmed.indexOf("=");
+                const key = trimmed.slice(0, eq).trim();
+                let value = trimmed.slice(eq + 1).trim();
+                if ((value.startsWith('"') && value.endsWith('"')) ||
+                    (value.startsWith("'") && value.endsWith("'"))) {
+                    value = value.slice(1, -1);
+                }
+                if (key && process.env[key] === undefined) {
+                    process.env[key] = value;
+                }
+            }
+            loaded.push(path);
+        }
+        catch {
+            continue;
+        }
+    }
+    return loaded;
+}
+//# sourceMappingURL=env-autoload.js.map

package/dist/llm/env-autoload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-autoload.js","sourceRoot":"","sources":["../../src/llm/env-autoload.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,oBAAoB,GAAG;IAC3B,aAAa;IACb,QAAQ;IACR,SAAS;IACT,YAAY;CACb,CAAC;AAEF,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,aAAoC,EAAE;IAChE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,CAAC,GAAG,oBAAoB,EAAE,GAAG,UAAU,CAAC,CAAC;IACvD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QAChC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3C,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC5B,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;oBAAE,SAAS;gBAC5E,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAChC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;gBACxC,IAAI,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACzC,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC;oBACD,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC7B,CAAC;gBACD,IAAI,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;oBAC1C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBAC3B,CAAC;YACH,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,47 @@
+/**
+ * OllamaClient — LLMClient backed by a local Ollama HTTP endpoint.
+ *
+ * embed()    → POST /api/embeddings  (nomic-embed-text by default)
+ * classify() → POST /api/chat        (phi4-mini by default, format=json)
+ *
+ * Network/HTTP failure maps to LLMUnreachableError so RecallService can
+ * degrade to keyword mode without crashing. Classification parse failures
+ * resolve to null (caller's choice whether to retry or route to inbox).
+ *
+ * Layering: this file lives in the outer ring. core/ depends on LLMClient,
+ * not on this concrete class. Tests can substitute a fake client.
+ */
+import type { ClassifyResult, EmbedResult, EmbeddingKind, LLMClient } from "../ports/llm-client.js";
+export type FetchImpl = typeof fetch;
+export declare function l2Normalize(vec: Float32Array): Float32Array;
+export interface OllamaClientOptions {
+    readonly baseUrl?: string;
+    readonly embedModel?: string;
+    readonly classifyModel?: string;
+    readonly timeoutMs?: number;
+    readonly classifyTimeoutMs?: number;
+    /** Inject a fake fetch for tests. Defaults to global fetch. */
+    readonly fetchImpl?: FetchImpl;
+}
+export declare class OllamaClient implements LLMClient {
+    private readonly baseUrl;
+    private readonly embedModel;
+    private readonly classifyModel;
+    private readonly timeoutMs;
+    private readonly classifyTimeoutMs;
+    private readonly fetchImpl;
+    constructor(opts?: OllamaClientOptions);
+    embed(text: string, kind: EmbeddingKind): Promise<EmbedResult>;
+    /**
+     * Send a transcript through the Ollama classifier with the shared system
+     * prompt. Returns a ClassifyResult on success, or throws on network failure
+     * (LLMUnreachableError) or schema-invalid output (Error). The Python
+     * counterpart returned None on parse failure; we throw a typed error so
+     * callers explicitly handle retry / inbox routing rather than swallowing
+     * silent nulls.
+     */
+    classify(transcript: string, priorContext?: string): Promise<ClassifyResult>;
+}
+export declare class ClassifierSchemaError extends Error {
+    constructor(message: string);
+}

package/dist/llm/ollama-client.js

@@ -0,0 +1,156 @@
+/**
+ * OllamaClient — LLMClient backed by a local Ollama HTTP endpoint.
+ *
+ * embed()    → POST /api/embeddings  (nomic-embed-text by default)
+ * classify() → POST /api/chat        (phi4-mini by default, format=json)
+ *
+ * Network/HTTP failure maps to LLMUnreachableError so RecallService can
+ * degrade to keyword mode without crashing. Classification parse failures
+ * resolve to null (caller's choice whether to retry or route to inbox).
+ *
+ * Layering: this file lives in the outer ring. core/ depends on LLMClient,
+ * not on this concrete class. Tests can substitute a fake client.
+ */
+import { LLMUnreachableError } from "../ports/llm-client.js";
+import { CLASSIFIER_SYSTEM_PROMPT, buildUserPrompt, coerceClassifyResult, stripJsonFences, validateClassifierJson, } from "../core/classifier/prompt.js";
+// Tried raising 8000 → 28000 on 2026-05-25 to recover the answer-tail of
+// long gold sessions (median LongMemEval-S gold body is 14,294 chars). The
+// Ollama /api/embeddings endpoint returned 500 on 54% of those large
+// inputs despite nomic-embed-text's nominal 8192-token context — semantic
+// R@5 collapsed from 87.2% → 15.8%. Reverted. Real fix is chunk + max-pool
+// (each body split into ≤8K-char chunks, store all vectors, score against
+// max cosine at query time) so coverage doesn't depend on a single embed
+// call. Filed as #174.
+const MAX_EMBED_CHARS = 8_000;
+const EMBED_PREFIXES = {
+    query: "search_query: ",
+    document: "search_document: ",
+};
+export function l2Normalize(vec) {
+    let sumSq = 0;
+    for (let i = 0; i < vec.length; i++) {
+        const v = vec[i] ?? 0;
+        sumSq += v * v;
+    }
+    if (sumSq === 0)
+        return vec;
+    const norm = Math.sqrt(sumSq);
+    const out = new Float32Array(vec.length);
+    for (let i = 0; i < vec.length; i++) {
+        out[i] = (vec[i] ?? 0) / norm;
+    }
+    return out;
+}
+export class OllamaClient {
+    baseUrl;
+    embedModel;
+    classifyModel;
+    timeoutMs;
+    classifyTimeoutMs;
+    fetchImpl;
+    constructor(opts = {}) {
+        this.baseUrl = (opts.baseUrl ?? "http://localhost:11434").replace(/\/+$/, "");
+        this.embedModel = opts.embedModel ?? "nomic-embed-text";
+        this.classifyModel = opts.classifyModel ?? "phi4-mini:latest";
+        this.timeoutMs = opts.timeoutMs ?? 10_000;
+        this.classifyTimeoutMs = opts.classifyTimeoutMs ?? 180_000;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+    }
+    async embed(text, kind) {
+        // nomic-embed-text v1.5 is an asymmetric retrieval model. The
+        // search_query:/search_document: prefix is part of the training
+        // contract; omitting it or using the wrong one degrades retrieval
+        // quality measurably. MAX_EMBED_CHARS matches the Python ceiling.
+        const truncated = text.slice(0, MAX_EMBED_CHARS);
+        const prompt = `${EMBED_PREFIXES[kind]}${truncated}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        try {
+            const res = await this.fetchImpl(`${this.baseUrl}/api/embeddings`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({ model: this.embedModel, prompt }),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                throw new LLMUnreachableError("ollama", `status ${res.status}`);
+            }
+            const data = (await res.json());
+            if (!data.embedding || data.embedding.length === 0) {
+                throw new LLMUnreachableError("ollama", "empty embedding");
+            }
+            const raw = new Float32Array(data.embedding);
+            return { vector: l2Normalize(raw), model: this.embedModel };
+        }
+        catch (e) {
+            if (e instanceof LLMUnreachableError)
+                throw e;
+            throw new LLMUnreachableError("ollama", e);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Send a transcript through the Ollama classifier with the shared system
+     * prompt. Returns a ClassifyResult on success, or throws on network failure
+     * (LLMUnreachableError) or schema-invalid output (Error). The Python
+     * counterpart returned None on parse failure; we throw a typed error so
+     * callers explicitly handle retry / inbox routing rather than swallowing
+     * silent nulls.
+     */
+    async classify(transcript, priorContext = "") {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.classifyTimeoutMs);
+        try {
+            const userPrompt = buildUserPrompt(transcript, priorContext);
+            const res = await this.fetchImpl(`${this.baseUrl}/api/chat`, {
+                method: "POST",
+                headers: { "Content-Type": "application/json" },
+                body: JSON.stringify({
+                    model: this.classifyModel,
+                    messages: [
+                        { role: "system", content: CLASSIFIER_SYSTEM_PROMPT },
+                        { role: "user", content: userPrompt },
+                    ],
+                    stream: false,
+                    format: "json",
+                    options: { temperature: 0.1 },
+                }),
+                signal: controller.signal,
+            });
+            if (!res.ok) {
+                throw new LLMUnreachableError("ollama", `status ${res.status}`);
+            }
+            const data = (await res.json());
+            const rawContent = data.message?.content?.trim() ?? "";
+            const content = stripJsonFences(rawContent);
+            let parsed;
+            try {
+                parsed = JSON.parse(content);
+            }
+            catch {
+                throw new ClassifierSchemaError("ollama returned non-JSON content");
+            }
+            if (!validateClassifierJson(parsed)) {
+                throw new ClassifierSchemaError("ollama response missing required keys");
+            }
+            return coerceClassifyResult(parsed);
+        }
+        catch (e) {
+            if (e instanceof LLMUnreachableError || e instanceof ClassifierSchemaError)
+                throw e;
+            throw new LLMUnreachableError("ollama", e);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+export class ClassifierSchemaError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ClassifierSchemaError";
+    }
+}
+//# sourceMappingURL=ollama-client.js.map

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

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,64 @@
+/**
+ * MCP adapter. Binds the `recall_sessions` and `get_session` tools directly
+ * to RecallService and SessionStore — no HTTP hop, no localhost loopback.
+ *
+ * The Python daemon's MCP server proxied through HTTP. This server runs in
+ * the same process as the rest of nlm-memory, so a tool call is a function
+ * call. Lower latency, simpler stack traces, one fewer thing to keep alive.
+ *
+ * Layering: this module knows about the inner ring (RecallService,
+ * SessionStore); core/ does not know this module exists.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { FactRecallService } from "../core/recall-facts/fact-recall-service.js";
+import type { RecallService } from "../core/recall/recall-service.js";
+import type { FactStore } from "../ports/fact-store.js";
+import type { SessionStore } from "../ports/session-store.js";
+import type { FactKind, RecallKindFilter, RecallMode } from "../shared/types.js";
+export interface McpDeps {
+    readonly recall: RecallService;
+    readonly store: SessionStore;
+    /** Optional — when absent, fact tools are not registered. */
+    readonly factRecall?: FactRecallService;
+    readonly factStore?: FactStore;
+}
+export interface ToolResult {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: boolean;
+}
+export interface RecallToolInput {
+    query: string | undefined;
+    entity: string | undefined;
+    kind: RecallKindFilter | undefined;
+    mode: RecallMode | undefined;
+    limit: number | undefined;
+}
+export declare function recallSessionsHandler(deps: McpDeps, input: Partial<RecallToolInput>): Promise<ToolResult>;
+export declare function getSessionHandler(deps: McpDeps, input: {
+    id: string;
+}): Promise<ToolResult>;
+export interface RecallFactsInput {
+    query: string | undefined;
+    subject: string | undefined;
+    predicate: string | undefined;
+    kind: FactKind | undefined;
+    mode: RecallMode | undefined;
+    includeSuperseded: boolean | undefined;
+    minConfidence: number | undefined;
+    limit: number | undefined;
+}
+export declare function recallFactsHandler(deps: McpDeps, input: Partial<RecallFactsInput>): Promise<ToolResult>;
+export declare function getFactHistoryHandler(deps: McpDeps, input: {
+    subject: string;
+    predicate: string | undefined;
+}): Promise<ToolResult>;
+export interface CiteSessionInput {
+    readonly id: string;
+    readonly conversation_id?: string | undefined;
+    readonly reason?: string | undefined;
+}
+export declare function citeSessionHandler(input: CiteSessionInput): Promise<ToolResult>;
+export declare function createMcpServer(deps: McpDeps): McpServer;