nlm-memory 0.4.0

package/dist/core/providers/provider-models.js

@@ -0,0 +1,72 @@
+/**
+ * Provider model discovery — runtime lookup of available models.
+ *
+ * Per-kind strategy:
+ *   - ollama:            GET {baseUrl}/api/tags
+ *   - openai:            GET {baseUrl}/models with Bearer key
+ *   - openrouter:        GET {baseUrl}/models with Bearer key
+ *   - openai-compatible: GET {baseUrl}/models, key optional
+ *   - deepseek:          hardcoded (no public list endpoint)
+ *   - anthropic:         hardcoded (their /v1/models exists but
+ *                         requires beta header + returns subsets;
+ *                         a hardcoded list is more reliable)
+ *
+ * Returns a flat `string[]`. Errors throw — callers (the HTTP endpoint
+ * and connection-test) catch and surface to the user.
+ */
+const HARDCODED_MODELS = {
+    deepseek: ["deepseek-v4-flash", "deepseek-v4-pro", "deepseek-chat"],
+    anthropic: [
+        "claude-opus-4-7",
+        "claude-sonnet-4-6",
+        "claude-haiku-4-5-20251001",
+    ],
+};
+export async function listModels(provider, opts = {}) {
+    const hardcoded = HARDCODED_MODELS[provider.kind];
+    if (hardcoded)
+        return [...hardcoded];
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const timeoutMs = opts.timeoutMs ?? 10_000;
+    const baseUrl = (provider.baseUrl ?? "").replace(/\/+$/, "");
+    if (!baseUrl)
+        throw new Error(`${provider.name}: baseUrl not configured`);
+    if (provider.kind === "ollama") {
+        return fetchOllamaModels(baseUrl, fetchImpl, timeoutMs);
+    }
+    return fetchOpenAIModels(baseUrl, opts.apiKey ?? null, fetchImpl, timeoutMs);
+}
+async function fetchOllamaModels(baseUrl, fetchImpl, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetchImpl(`${baseUrl}/api/tags`, { signal: controller.signal });
+        if (!res.ok)
+            throw new Error(`Ollama returned ${res.status}`);
+        const data = (await res.json());
+        const names = (data.models ?? []).map((m) => m.name).filter((n) => typeof n === "string");
+        return names.sort();
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function fetchOpenAIModels(baseUrl, apiKey, fetchImpl, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const headers = {};
+        if (apiKey)
+            headers["Authorization"] = `Bearer ${apiKey}`;
+        const res = await fetchImpl(`${baseUrl}/models`, { signal: controller.signal, headers });
+        if (!res.ok)
+            throw new Error(`${res.status} ${res.statusText}`);
+        const data = (await res.json());
+        const ids = (data.data ?? []).map((m) => m.id).filter((s) => typeof s === "string");
+        return ids.sort();
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=provider-models.js.map

package/dist/core/providers/provider-models.js.map

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

package/dist/core/providers/provider-registry.d.ts

@@ -0,0 +1,62 @@
+/**
+ * ProviderRegistry — CRUD over the `providers` table.
+ *
+ * One row per LLM endpoint the user has configured. The classifier reads
+ * this at boot to pick a provider/model; the UI lets users add their own.
+ *
+ * API keys live in the `api_key` column today. Phase 2 (Tauri shell)
+ * migrates them to the OS keychain; the API shape stays identical so this
+ * module's consumers don't change.
+ *
+ * `redact()` strips secrets on the way out — every HTTP response sends
+ * redacted rows, with the key only retrievable via getSecret() inside the
+ * daemon process.
+ */
+import type Database from "better-sqlite3";
+export type ProviderKind = "deepseek" | "ollama" | "openai" | "anthropic" | "openrouter" | "openai-compatible";
+export interface ProviderRow {
+    readonly id: number;
+    readonly kind: ProviderKind;
+    readonly name: string;
+    readonly baseUrl: string | null;
+    /** Always `null` on rows returned by `list()` / `get()`. Use `getSecret()`. */
+    readonly apiKey: string | null;
+    readonly hasApiKey: boolean;
+    readonly defaultModel: string | null;
+    readonly enabled: boolean;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface ProviderInsert {
+    readonly kind: ProviderKind;
+    readonly name: string;
+    readonly baseUrl?: string | null;
+    readonly apiKey?: string | null;
+    readonly defaultModel?: string | null;
+    readonly enabled?: boolean;
+}
+export interface ProviderUpdate {
+    readonly name?: string;
+    readonly baseUrl?: string | null;
+    readonly apiKey?: string | null;
+    readonly defaultModel?: string | null;
+    readonly enabled?: boolean;
+}
+export declare class ProviderRegistry {
+    private readonly db;
+    constructor(db: Database.Database);
+    list(): ProviderRow[];
+    get(id: number): ProviderRow | null;
+    getByName(name: string): ProviderRow | null;
+    /** Returns the secret. Use only inside the daemon — never echo to HTTP. */
+    getSecret(id: number): string | null;
+    insert(input: ProviderInsert): ProviderRow;
+    update(id: number, patch: ProviderUpdate): ProviderRow | null;
+    delete(id: number): boolean;
+    /**
+     * Seed defaults on an empty registry. Bridges from the legacy env-var
+     * setup: if DEEPSEEK_API_KEY is present, the DeepSeek row carries it
+     * forward; Ollama is always seeded since it needs no key.
+     */
+    seedDefaults(): void;
+}

package/dist/core/providers/provider-registry.js

@@ -0,0 +1,143 @@
+/**
+ * ProviderRegistry — CRUD over the `providers` table.
+ *
+ * One row per LLM endpoint the user has configured. The classifier reads
+ * this at boot to pick a provider/model; the UI lets users add their own.
+ *
+ * API keys live in the `api_key` column today. Phase 2 (Tauri shell)
+ * migrates them to the OS keychain; the API shape stays identical so this
+ * module's consumers don't change.
+ *
+ * `redact()` strips secrets on the way out — every HTTP response sends
+ * redacted rows, with the key only retrievable via getSecret() inside the
+ * daemon process.
+ */
+function rowFromDb(r, includeSecret) {
+    return {
+        id: r.id,
+        kind: r.kind,
+        name: r.name,
+        baseUrl: r.base_url,
+        apiKey: includeSecret ? r.api_key : null,
+        hasApiKey: r.api_key !== null && r.api_key.length > 0,
+        defaultModel: r.default_model,
+        enabled: r.enabled === 1,
+        createdAt: r.created_at,
+        updatedAt: r.updated_at,
+    };
+}
+const DEFAULT_BASE_URLS = {
+    deepseek: "https://api.deepseek.com",
+    ollama: "http://localhost:11434",
+    openai: "https://api.openai.com/v1",
+    anthropic: "https://api.anthropic.com",
+    openrouter: "https://openrouter.ai/api/v1",
+    "openai-compatible": null,
+};
+const DEFAULT_MODELS = {
+    deepseek: "deepseek-v4-flash",
+    ollama: "phi4-mini:latest",
+    openai: "gpt-4o-mini",
+    anthropic: "claude-haiku-4-5-20251001",
+    openrouter: "anthropic/claude-haiku-4-5",
+    "openai-compatible": null,
+};
+export class ProviderRegistry {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    list() {
+        const rows = this.db.prepare(`SELECT * FROM providers ORDER BY id ASC`).all();
+        return rows.map((r) => rowFromDb(r, false));
+    }
+    get(id) {
+        const row = this.db.prepare(`SELECT * FROM providers WHERE id = ?`).get(id);
+        return row ? rowFromDb(row, false) : null;
+    }
+    getByName(name) {
+        const row = this.db.prepare(`SELECT * FROM providers WHERE name = ?`).get(name);
+        return row ? rowFromDb(row, false) : null;
+    }
+    /** Returns the secret. Use only inside the daemon — never echo to HTTP. */
+    getSecret(id) {
+        const row = this.db.prepare(`SELECT * FROM providers WHERE id = ?`).get(id);
+        return row?.api_key ?? null;
+    }
+    insert(input) {
+        const baseUrl = input.baseUrl ?? DEFAULT_BASE_URLS[input.kind];
+        const defaultModel = input.defaultModel ?? DEFAULT_MODELS[input.kind];
+        const result = this.db.prepare(`
+      INSERT INTO providers (kind, name, base_url, api_key, default_model, enabled)
+      VALUES (@kind, @name, @base_url, @api_key, @default_model, @enabled)
+    `).run({
+            kind: input.kind,
+            name: input.name,
+            base_url: baseUrl ?? null,
+            api_key: input.apiKey ?? null,
+            default_model: defaultModel ?? null,
+            enabled: input.enabled === false ? 0 : 1,
+        });
+        const id = Number(result.lastInsertRowid);
+        const row = this.get(id);
+        if (!row)
+            throw new Error(`ProviderRegistry.insert: row ${id} not found after insert`);
+        return row;
+    }
+    update(id, patch) {
+        const fields = [];
+        const params = { id };
+        if (patch.name !== undefined) {
+            fields.push("name = @name");
+            params["name"] = patch.name;
+        }
+        if (patch.baseUrl !== undefined) {
+            fields.push("base_url = @url");
+            params["url"] = patch.baseUrl;
+        }
+        if (patch.apiKey !== undefined) {
+            fields.push("api_key = @key");
+            params["key"] = patch.apiKey;
+        }
+        if (patch.defaultModel !== undefined) {
+            fields.push("default_model = @m");
+            params["m"] = patch.defaultModel;
+        }
+        if (patch.enabled !== undefined) {
+            fields.push("enabled = @en");
+            params["en"] = patch.enabled ? 1 : 0;
+        }
+        if (fields.length === 0)
+            return this.get(id);
+        fields.push("updated_at = datetime('now')");
+        this.db.prepare(`UPDATE providers SET ${fields.join(", ")} WHERE id = @id`).run(params);
+        return this.get(id);
+    }
+    delete(id) {
+        const result = this.db.prepare(`DELETE FROM providers WHERE id = ?`).run(id);
+        return result.changes > 0;
+    }
+    /**
+     * Seed defaults on an empty registry. Bridges from the legacy env-var
+     * setup: if DEEPSEEK_API_KEY is present, the DeepSeek row carries it
+     * forward; Ollama is always seeded since it needs no key.
+     */
+    seedDefaults() {
+        const count = this.db.prepare(`SELECT COUNT(*) AS c FROM providers`).get();
+        if ((count?.c ?? 0) > 0)
+            return;
+        this.insert({
+            kind: "ollama",
+            name: "Ollama (local)",
+            baseUrl: process.env["NLM_OLLAMA_URL"] ?? "http://localhost:11434",
+        });
+        const deepseekKey = process.env["DEEPSEEK_API_KEY"];
+        this.insert({
+            kind: "deepseek",
+            name: "DeepSeek",
+            apiKey: deepseekKey ?? null,
+            enabled: Boolean(deepseekKey),
+        });
+    }
+}
+//# sourceMappingURL=provider-registry.js.map

package/dist/core/providers/provider-registry.js.map

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

package/dist/core/recall/citation-log.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Append-only JSONL citation log. One line per (conversationId, citedId)
+ * that the Stop hook detected. This is the training-data substrate for the
+ * future learned reranker: each row is a (query, returned_id, was_cited)
+ * triple once joined against ~/.nlm/query_log.jsonl by conversationId.
+ *
+ * Path defaults to ~/.nlm/citation-log.jsonl, overridable via
+ * NLM_CITATION_LOG. Telemetry path — never raises.
+ */
+export type CitationKind = "tool_use" | "prose";
+export interface CitationEntry {
+    readonly conversationId: string;
+    readonly citedId: string;
+    readonly kind?: CitationKind;
+    readonly responsePreview?: string;
+}
+export interface CitationStats {
+    readonly days: number;
+    readonly total: number;
+    readonly distinct_ids: number;
+    readonly top_ids: ReadonlyArray<{
+        readonly id: string;
+        readonly count: number;
+    }>;
+    readonly log_present: boolean;
+}
+export declare function appendCitation(entry: CitationEntry, logPath?: string): Promise<void>;
+export declare function citationStats(days: number, logPath?: string): Promise<CitationStats>;

package/dist/core/recall/citation-log.js

@@ -0,0 +1,90 @@
+/**
+ * Append-only JSONL citation log. One line per (conversationId, citedId)
+ * that the Stop hook detected. This is the training-data substrate for the
+ * future learned reranker: each row is a (query, returned_id, was_cited)
+ * triple once joined against ~/.nlm/query_log.jsonl by conversationId.
+ *
+ * Path defaults to ~/.nlm/citation-log.jsonl, overridable via
+ * NLM_CITATION_LOG. Telemetry path — never raises.
+ */
+import { appendFile, mkdir, readFile, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { homedir } from "node:os";
+function defaultLogPath() {
+    return process.env["NLM_CITATION_LOG"] ?? join(homedir(), ".nlm", "citation-log.jsonl");
+}
+export async function appendCitation(entry, logPath = defaultLogPath()) {
+    try {
+        await mkdir(dirname(logPath), { recursive: true });
+        const payload = {
+            ts: new Date().toISOString(),
+            conversation_id: entry.conversationId,
+            cited_id: entry.citedId,
+            ...(entry.kind !== undefined ? { kind: entry.kind } : {}),
+            ...(entry.responsePreview !== undefined
+                ? { response_preview: entry.responsePreview }
+                : {}),
+        };
+        await appendFile(logPath, JSON.stringify(payload) + "\n", "utf8");
+    }
+    catch {
+        // Telemetry failure must never break the call path.
+    }
+}
+export async function citationStats(days, logPath = defaultLogPath()) {
+    const base = {
+        days,
+        total: 0,
+        distinct_ids: 0,
+        top_ids: [],
+        log_present: false,
+    };
+    try {
+        await stat(logPath);
+    }
+    catch {
+        return base;
+    }
+    let raw;
+    try {
+        raw = await readFile(logPath, "utf8");
+    }
+    catch {
+        return { ...base, log_present: true };
+    }
+    const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+    const counts = new Map();
+    let total = 0;
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let entry;
+        try {
+            entry = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        const tsRaw = entry["ts"];
+        if (typeof tsRaw !== "string")
+            continue;
+        const ts = Date.parse(tsRaw);
+        if (!Number.isFinite(ts) || ts < cutoff)
+            continue;
+        const id = entry["cited_id"];
+        if (typeof id !== "string" || !id)
+            continue;
+        total += 1;
+        counts.set(id, (counts.get(id) ?? 0) + 1);
+    }
+    const sorted = [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 20);
+    return {
+        days,
+        total,
+        distinct_ids: counts.size,
+        top_ids: sorted.map(([id, count]) => ({ id, count })),
+        log_present: true,
+    };
+}
+//# sourceMappingURL=citation-log.js.map

package/dist/core/recall/citation-log.js.map

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

package/dist/core/recall/filter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Session-list filters used before scoring.
+ *
+ * Pure function over a session array. Mirrors recall.py:_apply_filters.
+ */
+import type { Session, RecallKindFilter } from "../../shared/types.js";
+export interface RecallFilter {
+    readonly entity?: string;
+    readonly kind?: RecallKindFilter;
+}
+export declare function applyFilter(sessions: ReadonlyArray<Session>, filter: RecallFilter): ReadonlyArray<Session>;

package/dist/core/recall/filter.js

@@ -0,0 +1,20 @@
+/**
+ * Session-list filters used before scoring.
+ *
+ * Pure function over a session array. Mirrors recall.py:_apply_filters.
+ */
+export function applyFilter(sessions, filter) {
+    const { entity, kind } = filter;
+    if (!entity && !kind)
+        return sessions;
+    return sessions.filter((s) => {
+        if (entity && !s.entities.includes(entity))
+            return false;
+        if (kind === "decision" && s.decisions.length === 0)
+            return false;
+        if (kind === "open" && s.open.length === 0)
+            return false;
+        return true;
+    });
+}
+//# sourceMappingURL=filter.js.map

package/dist/core/recall/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../../src/core/recall/filter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,UAAU,WAAW,CACzB,QAAgC,EAChC,MAAoB;IAEpB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAChC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;QAAE,OAAO,QAAQ,CAAC;IAEtC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC3B,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QACzD,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAClE,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACzD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/recall/index.d.ts

@@ -0,0 +1,6 @@
+export { RecallService } from "./recall-service.js";
+export type { RecallServiceDeps } from "./recall-service.js";
+export { keywordMatchFields } from "./match-fields.js";
+export { applyFilter } from "./filter.js";
+export type { RecallFilter } from "./filter.js";
+export { tokenize, tokenSet } from "./tokenize.js";

package/dist/core/recall/index.js

@@ -0,0 +1,5 @@
+export { RecallService } from "./recall-service.js";
+export { keywordMatchFields } from "./match-fields.js";
+export { applyFilter } from "./filter.js";
+export { tokenize, tokenSet } from "./tokenize.js";
+//# sourceMappingURL=index.js.map

package/dist/core/recall/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/recall/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}

package/dist/core/recall/match-fields.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Computes which session fields a keyword query matched, for the `matchedIn`
+ * badge on a RecallHit. Pure function — no DB, no I/O. FTS5 BM25 ranks the
+ * whole row; this recovers per-field attribution from the resolved Session,
+ * including decisions/open which live in the markers table (not in FTS).
+ */
+import type { MatchField, Session } from "../../shared/types.js";
+type SessionFields = Pick<Session, "label" | "summary" | "decisions" | "open">;
+export declare function keywordMatchFields(session: SessionFields, queryTokens: ReadonlySet<string>): ReadonlyArray<MatchField>;
+export {};

package/dist/core/recall/match-fields.js

@@ -0,0 +1,37 @@
+/**
+ * Computes which session fields a keyword query matched, for the `matchedIn`
+ * badge on a RecallHit. Pure function — no DB, no I/O. FTS5 BM25 ranks the
+ * whole row; this recovers per-field attribution from the resolved Session,
+ * including decisions/open which live in the markers table (not in FTS).
+ */
+import { tokenSet } from "./tokenize.js";
+export function keywordMatchFields(session, queryTokens) {
+    if (queryTokens.size === 0)
+        return [];
+    const fields = [];
+    if (overlaps(queryTokens, tokenSet(session.label)))
+        fields.push("label");
+    if (overlaps(queryTokens, joinedTokens(session.decisions)))
+        fields.push("decisions");
+    if (overlaps(queryTokens, joinedTokens(session.open)))
+        fields.push("open");
+    if (overlaps(queryTokens, tokenSet(session.summary)))
+        fields.push("summary");
+    return fields;
+}
+function joinedTokens(values) {
+    const out = new Set();
+    for (const v of values) {
+        for (const t of tokenSet(v))
+            out.add(t);
+    }
+    return out;
+}
+function overlaps(a, b) {
+    const [small, large] = a.size <= b.size ? [a, b] : [b, a];
+    for (const item of small)
+        if (large.has(item))
+            return true;
+    return false;
+}
+//# sourceMappingURL=match-fields.js.map

package/dist/core/recall/match-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match-fields.js","sourceRoot":"","sources":["../../../src/core/recall/match-fields.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAIzC,MAAM,UAAU,kBAAkB,CAChC,OAAsB,EACtB,WAAgC;IAEhC,IAAI,WAAW,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,IAAI,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzE,IAAI,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACrF,IAAI,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3E,IAAI,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE7E,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,YAAY,CAAC,MAA6B;IACjD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,CAAsB,EAAE,CAAsB;IAC9D,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/recall/query-log.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Query log + stats aggregation. Mirrors recall.py's log_query() / stats().
+ *
+ * Telemetry path — never raises. The HTTP recall handler calls logQuery()
+ * after each /api/recall response; /api/recall/stats reads the same file
+ * back to drive the Pulse agent-recall observability panel.
+ *
+ * File format: one JSON object per line at $NLM_QUERY_LOG or
+ * ~/.nlm/query_log.jsonl. Append-only.
+ */
+import type { RecallKindFilter, RecallMode } from "../../shared/types.js";
+export interface LogEntry {
+    readonly source: string;
+    readonly query: string | null;
+    readonly entity: string | null;
+    readonly kind: RecallKindFilter | null;
+    readonly mode: RecallMode;
+    readonly limit: number;
+    readonly nResults: number;
+    readonly returnedIds: ReadonlyArray<string>;
+}
+export interface StatsResult {
+    readonly days: number;
+    readonly total: number;
+    readonly with_results: number;
+    readonly hit_rate: number;
+    readonly useful_hit_rate: number | null;
+    readonly by_source: Record<string, number>;
+    readonly top_queries: ReadonlyArray<{
+        readonly query: string;
+        readonly count: number;
+    }>;
+    readonly log_present: boolean;
+}
+export declare function logQuery(entry: LogEntry, logPath?: string): Promise<void>;
+export declare function recallStats(days: number, logPath?: string, usefulHitLogPath?: string): Promise<StatsResult>;