nlm-memory 0.4.0

package/dist/core/hook/memo-sweep.js

@@ -0,0 +1,134 @@
+/**
+ * Idle sweep for per-conversation hook memo files.
+ *
+ * The SessionEnd hook is best-effort — Claude Code doesn't fire it on
+ * crashes, kill -9, or IDE force-close. Without a backstop, memo files
+ * at ~/.nlm/hook-state/<conv>.json accumulate forever for any session
+ * that didn't close cleanly.
+ *
+ * This sweep is the daemon-side backstop. It runs on a timer, scans the
+ * state directory, and deletes any memo whose mtime is older than the
+ * dormant threshold. Reuses the same `age > day` threshold the dataset
+ * builder uses to mark runtimes as "dormant" so the UI/dataset semantics
+ * stay consistent across the system.
+ *
+ * Hooks are fast-path; this is the always-correct backstop.
+ */
+import { existsSync, readdirSync, rmSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// Mirrors the dormant threshold in build-dataset.ts:
+//   age <= hour  → "active"
+//   age <= day   → "idle"
+//   age > day    → "dormant"
+// We sweep memos that are dormant.
+const DEFAULT_DORMANT_MS = 24 * 60 * 60 * 1000;
+const DEFAULT_INTERVAL_MS = 5 * 60 * 1000;
+function defaultStateDir() {
+    return process.env["NLM_HOOK_STATE_DIR"] ?? join(homedir(), ".nlm", "hook-state");
+}
+/**
+ * One-shot sweep. Returns the report; safe to call from tests or one-off
+ * CLI invocations without standing up the scheduler.
+ */
+export function sweepMemoDir(opts = {}) {
+    const stateDir = opts.stateDir ?? defaultStateDir();
+    const dormantMs = opts.dormantMs ?? DEFAULT_DORMANT_MS;
+    const now = opts.now ?? Date.now;
+    const logger = opts.logger ?? ((msg) => console.error(msg));
+    if (!existsSync(stateDir)) {
+        return { scanned: 0, deleted: 0, kept: 0, errors: 0 };
+    }
+    let entries;
+    try {
+        entries = readdirSync(stateDir);
+    }
+    catch (e) {
+        logger(`[memo-sweep] readdir failed for ${stateDir}: ${e instanceof Error ? e.message : String(e)}`);
+        return { scanned: 0, deleted: 0, kept: 0, errors: 1 };
+    }
+    const cutoff = now() - dormantMs;
+    let deleted = 0;
+    let kept = 0;
+    let errors = 0;
+    for (const name of entries) {
+        if (!name.endsWith(".json")) {
+            // Don't touch files we don't own (kept silently, don't even count).
+            continue;
+        }
+        const path = join(stateDir, name);
+        try {
+            const stat = statSync(path);
+            if (stat.mtimeMs < cutoff) {
+                rmSync(path);
+                deleted += 1;
+            }
+            else {
+                kept += 1;
+            }
+        }
+        catch (e) {
+            errors += 1;
+            logger(`[memo-sweep] failed on ${path}: ${e instanceof Error ? e.message : String(e)}`);
+        }
+    }
+    return { scanned: deleted + kept + errors, deleted, kept, errors };
+}
+/**
+ * Periodic sweep loop. Mirrors ScanScheduler's start/stop shape so the
+ * daemon can manage it the same way. First tick fires immediately on
+ * start() — the daemon picking up after a long downtime should sweep
+ * accumulated memos right away, not wait an interval.
+ */
+export class MemoSweepScheduler {
+    opts;
+    stopped = true;
+    timer = null;
+    constructor(opts = {}) {
+        this.opts = {
+            stateDir: opts.stateDir,
+            dormantMs: opts.dormantMs ?? DEFAULT_DORMANT_MS,
+            intervalMs: opts.intervalMs ?? DEFAULT_INTERVAL_MS,
+            logger: opts.logger ?? ((msg) => console.error(msg)),
+            now: opts.now,
+        };
+    }
+    start() {
+        if (!this.stopped)
+            return;
+        this.stopped = false;
+        this.scheduleNext(0);
+    }
+    stop() {
+        this.stopped = true;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+    }
+    tick() {
+        return sweepMemoDir({
+            dormantMs: this.opts.dormantMs,
+            logger: this.opts.logger,
+            ...(this.opts.stateDir !== undefined ? { stateDir: this.opts.stateDir } : {}),
+            ...(this.opts.now !== undefined ? { now: this.opts.now } : {}),
+        });
+    }
+    scheduleNext(delayMs) {
+        if (this.stopped)
+            return;
+        this.timer = setTimeout(() => {
+            try {
+                this.tick();
+            }
+            catch (e) {
+                this.opts.logger(`[memo-sweep] tick crashed: ${e instanceof Error ? e.message : String(e)}`);
+            }
+            this.scheduleNext(this.opts.intervalMs);
+        }, delayMs);
+        // Don't keep the event loop alive just for the sweep.
+        if (this.timer && typeof this.timer.unref === "function")
+            this.timer.unref();
+    }
+}
+//# sourceMappingURL=memo-sweep.js.map

package/dist/core/hook/memo-sweep.js.map

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

package/dist/core/hook/memo.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Per-conversation dedup memo for the recall hook. One JSON file per
+ * conversation holds the set of session ids already surfaced, so each is
+ * surfaced at most once per conversation.
+ *
+ * State dir defaults to ~/.nlm/hook-state/, overridable via
+ * NLM_HOOK_STATE_DIR (testability — mirrors query-log.ts).
+ *
+ * Every function is defensive: a missing or corrupt file yields an empty
+ * memo, and a write failure is swallowed. The hook must never break on memo
+ * I/O.
+ */
+export declare function loadSurfaced(conversationId: string): Set<string>;
+export declare function recordSurfaced(conversationId: string, ids: ReadonlyArray<string>): void;
+/**
+ * Delete the memo file for a closed conversation. Called by the SessionEnd
+ * hook so memo files don't accumulate forever. Returns true if a file was
+ * removed, false otherwise — callers may want to log the outcome.
+ */
+export declare function clearSurfaced(conversationId: string): boolean;

package/dist/core/hook/memo.js

@@ -0,0 +1,66 @@
+/**
+ * Per-conversation dedup memo for the recall hook. One JSON file per
+ * conversation holds the set of session ids already surfaced, so each is
+ * surfaced at most once per conversation.
+ *
+ * State dir defaults to ~/.nlm/hook-state/, overridable via
+ * NLM_HOOK_STATE_DIR (testability — mirrors query-log.ts).
+ *
+ * Every function is defensive: a missing or corrupt file yields an empty
+ * memo, and a write failure is swallowed. The hook must never break on memo
+ * I/O.
+ */
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+function stateDir() {
+    return process.env["NLM_HOOK_STATE_DIR"] ?? join(homedir(), ".nlm", "hook-state");
+}
+function memoPath(conversationId) {
+    const safe = conversationId.replace(/[^A-Za-z0-9_-]/g, "_") || "unknown";
+    return join(stateDir(), `${safe}.json`);
+}
+export function loadSurfaced(conversationId) {
+    try {
+        const path = memoPath(conversationId);
+        if (!existsSync(path))
+            return new Set();
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        if (!Array.isArray(parsed))
+            return new Set();
+        return new Set(parsed.filter((x) => typeof x === "string"));
+    }
+    catch {
+        return new Set();
+    }
+}
+export function recordSurfaced(conversationId, ids) {
+    try {
+        const merged = loadSurfaced(conversationId);
+        for (const id of ids)
+            merged.add(id);
+        mkdirSync(stateDir(), { recursive: true });
+        writeFileSync(memoPath(conversationId), JSON.stringify([...merged]), "utf8");
+    }
+    catch {
+        // Memo write failure must never break the hook.
+    }
+}
+/**
+ * Delete the memo file for a closed conversation. Called by the SessionEnd
+ * hook so memo files don't accumulate forever. Returns true if a file was
+ * removed, false otherwise — callers may want to log the outcome.
+ */
+export function clearSurfaced(conversationId) {
+    try {
+        const path = memoPath(conversationId);
+        if (!existsSync(path))
+            return false;
+        rmSync(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=memo.js.map

package/dist/core/hook/memo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.js","sourceRoot":"","sources":["../../../src/core/hook/memo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,SAAS,QAAQ;IACf,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AACpF,CAAC;AAED,SAAS,QAAQ,CAAC,cAAsB;IACtC,MAAM,IAAI,GAAG,cAAc,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC;IACzE,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,cAAsB;IACjD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QACxC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,GAAG,EAAE,CAAC;QAC7C,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,GAAG,EAAE,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,cAAsB,EACtB,GAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,YAAY,CAAC,cAAc,CAAC,CAAC;QAC5C,KAAK,MAAM,EAAE,IAAI,GAAG;YAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,SAAS,CAAC,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,aAAa,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IAC/E,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,cAAsB;IAClD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,cAAc,CAAC,CAAC;QACtC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,OAAO,KAAK,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/core/hook/pointer-block.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Renders the pointer block injected by the recall hook in live mode. Pure.
+ * Pointer-only by design: ids + labels, no session content. The footer
+ * names all four NLM MCP tools because the pointer block is the only
+ * cross-runtime distribution surface for teaching the tool inventory —
+ * fresh-install users never edit a prompt or settings file, so anything
+ * we want the agent to know about the tool surface ships here.
+ */
+export interface PointerHit {
+    readonly id: string;
+    readonly label: string;
+    readonly startedAt: string;
+}
+export declare function formatPointerBlock(hits: ReadonlyArray<PointerHit>): string;

package/dist/core/hook/pointer-block.js

@@ -0,0 +1,19 @@
+/**
+ * Renders the pointer block injected by the recall hook in live mode. Pure.
+ * Pointer-only by design: ids + labels, no session content. The footer
+ * names all four NLM MCP tools because the pointer block is the only
+ * cross-runtime distribution surface for teaching the tool inventory —
+ * fresh-install users never edit a prompt or settings file, so anything
+ * we want the agent to know about the tool surface ships here.
+ */
+export function formatPointerBlock(hits) {
+    if (hits.length === 0)
+        return "";
+    const lines = hits.map((h) => `- ${h.id} · ${h.label} (${h.startedAt.slice(0, 10)})`);
+    return [
+        "## Possibly-relevant prior sessions (nlm-memory)",
+        ...lines,
+        "NLM tools: recall_sessions (search), get_session (full transcript), recall_facts (prior decisions), get_fact_history (how a decision evolved).",
+    ].join("\n");
+}
+//# sourceMappingURL=pointer-block.js.map

package/dist/core/hook/pointer-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pointer-block.js","sourceRoot":"","sources":["../../../src/core/hook/pointer-block.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,MAAM,UAAU,kBAAkB,CAAC,IAA+B;IAChE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAC9D,CAAC;IACF,OAAO;QACL,kDAAkD;QAClD,GAAG,KAAK;QACR,gJAAgJ;KACjJ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/core/hook/select.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Selects which recall hits the hook surfaces. Pure — no I/O.
+ *
+ * Order of filtering: score threshold, then dedup against ids already
+ * surfaced in this conversation, then the per-fire cap bounded by the
+ * remaining per-conversation budget. Hits are assumed pre-ranked best-first.
+ */
+export interface RecallHitInput {
+    readonly id: string;
+    readonly label: string;
+    readonly startedAt: string;
+    readonly matchScore: number;
+}
+export interface SelectParams {
+    readonly hits: ReadonlyArray<RecallHitInput>;
+    readonly surfaced: ReadonlySet<string>;
+    readonly scoreThreshold: number;
+    readonly perFireCap: number;
+    readonly perConversationCap: number;
+}
+export declare function selectHits(params: SelectParams): ReadonlyArray<RecallHitInput>;

package/dist/core/hook/select.js

@@ -0,0 +1,15 @@
+/**
+ * Selects which recall hits the hook surfaces. Pure — no I/O.
+ *
+ * Order of filtering: score threshold, then dedup against ids already
+ * surfaced in this conversation, then the per-fire cap bounded by the
+ * remaining per-conversation budget. Hits are assumed pre-ranked best-first.
+ */
+export function selectHits(params) {
+    const { hits, surfaced, scoreThreshold, perFireCap, perConversationCap } = params;
+    const eligible = hits.filter((h) => h.matchScore >= scoreThreshold && !surfaced.has(h.id));
+    const budget = Math.max(0, perConversationCap - surfaced.size);
+    const limit = Math.min(perFireCap, budget);
+    return eligible.slice(0, limit);
+}
+//# sourceMappingURL=select.js.map

package/dist/core/hook/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../../src/core/hook/select.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC7C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAAC;IAClF,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAC1B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,cAAc,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAC7D,CAAC;IACF,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/core/hook/transcript.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Read assistant messages from a Claude Code transcript JSONL.
+ *
+ * Claude Code passes `transcript_path` in the Stop hook payload. Each line is
+ * a JSON object; assistant turns have `type:"assistant"` and a `message`
+ * object whose `content` is an array of blocks (`{type:"text", text:...}` for
+ * prose; `{type:"tool_use", name, input}` for tool invocations).
+ *
+ * Stop-hook citation detection needs the union of ALL assistant turns in the
+ * transcript, not just the last one: the model typically calls a tool, reads
+ * the result on the next user turn (tool_result), then writes a prose summary
+ * as a separate assistant turn. Scanning only the last turn misses the
+ * tool_use entirely. `readAllAssistantTurns` returns every assistant turn in
+ * order so the detector can fire across the whole conversation; cross-firing
+ * dedup happens upstream via the per-conversation cited memo.
+ *
+ * Fail-quiet: a malformed file yields nulls/empty rather than throwing —
+ * the Stop hook must never break on transcript I/O.
+ */
+export interface ToolUseBlock {
+    readonly name: string;
+    readonly input: unknown;
+}
+export interface AssistantTurn {
+    readonly text: string;
+    readonly toolUses: ReadonlyArray<ToolUseBlock>;
+}
+export declare function readAllAssistantTurns(transcriptPath: string): ReadonlyArray<AssistantTurn>;
+export declare function readLastAssistantTurn(transcriptPath: string): AssistantTurn;
+/** Back-compat shim for callers that only need prose. */
+export declare function readLastAssistantText(transcriptPath: string): string | null;

package/dist/core/hook/transcript.js

@@ -0,0 +1,103 @@
+/**
+ * Read assistant messages from a Claude Code transcript JSONL.
+ *
+ * Claude Code passes `transcript_path` in the Stop hook payload. Each line is
+ * a JSON object; assistant turns have `type:"assistant"` and a `message`
+ * object whose `content` is an array of blocks (`{type:"text", text:...}` for
+ * prose; `{type:"tool_use", name, input}` for tool invocations).
+ *
+ * Stop-hook citation detection needs the union of ALL assistant turns in the
+ * transcript, not just the last one: the model typically calls a tool, reads
+ * the result on the next user turn (tool_result), then writes a prose summary
+ * as a separate assistant turn. Scanning only the last turn misses the
+ * tool_use entirely. `readAllAssistantTurns` returns every assistant turn in
+ * order so the detector can fire across the whole conversation; cross-firing
+ * dedup happens upstream via the per-conversation cited memo.
+ *
+ * Fail-quiet: a malformed file yields nulls/empty rather than throwing —
+ * the Stop hook must never break on transcript I/O.
+ */
+import { existsSync, readFileSync } from "node:fs";
+const EMPTY_TURN = { text: "", toolUses: [] };
+function parseTurn(parsed) {
+    if (parsed.type !== "assistant" || !parsed.message)
+        return null;
+    const content = parsed.message.content;
+    if (typeof content === "string") {
+        return content ? { text: content, toolUses: [] } : null;
+    }
+    if (!Array.isArray(content))
+        return null;
+    const textParts = [];
+    const toolUses = [];
+    for (const block of content) {
+        if (block.type === "text" && typeof block.text === "string") {
+            textParts.push(block.text);
+        }
+        else if (block.type === "tool_use" && typeof block.name === "string") {
+            toolUses.push({ name: block.name, input: block.input });
+        }
+    }
+    if (textParts.length === 0 && toolUses.length === 0)
+        return null;
+    return { text: textParts.join("\n"), toolUses };
+}
+function readLines(transcriptPath) {
+    if (!transcriptPath || !existsSync(transcriptPath))
+        return null;
+    try {
+        return readFileSync(transcriptPath, "utf8").split("\n");
+    }
+    catch {
+        return null;
+    }
+}
+export function readAllAssistantTurns(transcriptPath) {
+    const lines = readLines(transcriptPath);
+    if (!lines)
+        return [];
+    const turns = [];
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (!line)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const turn = parseTurn(parsed);
+        if (turn)
+            turns.push(turn);
+    }
+    return turns;
+}
+export function readLastAssistantTurn(transcriptPath) {
+    const lines = readLines(transcriptPath);
+    if (!lines)
+        return EMPTY_TURN;
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i]?.trim();
+        if (!line)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        const turn = parseTurn(parsed);
+        if (turn)
+            return turn;
+    }
+    return EMPTY_TURN;
+}
+/** Back-compat shim for callers that only need prose. */
+export function readLastAssistantText(transcriptPath) {
+    const turn = readLastAssistantTurn(transcriptPath);
+    return turn.text || null;
+}
+//# sourceMappingURL=transcript.js.map

package/dist/core/hook/transcript.js.map

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

package/dist/core/ingest/ingest-session.d.ts

@@ -0,0 +1,40 @@
+/**
+ * ingestSession — push a single externally-supplied session through the
+ * normal classifier → embedder → store pipeline.
+ *
+ * Shared by the webhook endpoint (POST /api/ingest) and anything else
+ * that wants to push without going through a TranscriptAdapter. Mirrors
+ * the inner loop of ScanScheduler.runOnce but accepts a pre-built chunk.
+ */
+import type { SqliteFactStore } from "../storage/sqlite-fact-store.js";
+import type { SqliteSessionStore } from "../storage/sqlite-session-store.js";
+import type { LLMClient } from "../../ports/llm-client.js";
+export interface IngestInput {
+    /** Optional — if omitted, derived from a hash of (runtime + startedAt + text). */
+    readonly id?: string;
+    readonly runtime: string;
+    readonly runtimeSessionId?: string | null;
+    readonly text: string;
+    readonly startedAt?: string;
+    readonly endedAt?: string | null;
+    readonly transcriptPath?: string | null;
+    /** Webhook id when the source is webhook-pushed; null for generic. */
+    readonly sourceId?: number | null;
+}
+export interface IngestDeps {
+    readonly classifier: LLMClient;
+    readonly embedder: LLMClient;
+    readonly store: SqliteSessionStore;
+    readonly factStore?: SqliteFactStore;
+    /** Optional logger — defaults to console.error. */
+    readonly log?: (msg: string) => void;
+}
+export interface IngestResult {
+    readonly id: string;
+    readonly status: "ingested" | "low_confidence" | "classifier_failed";
+    readonly latencyMs: number;
+    readonly confidence?: number;
+    readonly error?: string;
+}
+export declare function deriveSessionId(runtime: string, startedAt: string, text: string): string;
+export declare function ingestSession(input: IngestInput, deps: IngestDeps): Promise<IngestResult>;

package/dist/core/ingest/ingest-session.js

@@ -0,0 +1,71 @@
+/**
+ * ingestSession — push a single externally-supplied session through the
+ * normal classifier → embedder → store pipeline.
+ *
+ * Shared by the webhook endpoint (POST /api/ingest) and anything else
+ * that wants to push without going through a TranscriptAdapter. Mirrors
+ * the inner loop of ScanScheduler.runOnce but accepts a pre-built chunk.
+ */
+import { createHash } from "node:crypto";
+import { extractFacts } from "../facts/extract-facts.js";
+const BODY_CAP = 200_000;
+const CONFIDENCE_FLOOR = 0.3;
+export function deriveSessionId(runtime, startedAt, text) {
+    const hash = createHash("sha256")
+        .update(runtime)
+        .update("|")
+        .update(startedAt)
+        .update("|")
+        .update(text.slice(0, 4_000))
+        .digest("hex")
+        .slice(0, 16);
+    return `webhook_${hash}`;
+}
+export async function ingestSession(input, deps) {
+    const startedAt = input.startedAt ?? new Date().toISOString();
+    const id = input.id ?? deriveSessionId(input.runtime, startedAt, input.text);
+    const log = deps.log ?? ((m) => console.error(m));
+    const t0 = Date.now();
+    let classification;
+    try {
+        classification = await deps.classifier.classify(input.text);
+    }
+    catch (e) {
+        const error = e instanceof Error ? e.message : String(e);
+        log(`[ingest] classifier failed for ${id}: ${error}`);
+        return { id, status: "classifier_failed", latencyMs: Date.now() - t0, error };
+    }
+    if (classification.confidence < CONFIDENCE_FLOOR) {
+        return {
+            id,
+            status: "low_confidence",
+            latencyMs: Date.now() - t0,
+            confidence: classification.confidence,
+        };
+    }
+    const record = {
+        id,
+        runtime: input.runtime,
+        runtimeSessionId: input.runtimeSessionId ?? null,
+        startedAt,
+        endedAt: input.endedAt ?? null,
+        durationMin: null,
+        label: classification.label,
+        summary: classification.summary,
+        body: input.text.slice(0, BODY_CAP),
+        status: "closed",
+        transcriptKind: "webhook",
+        transcriptPath: input.transcriptPath ?? null,
+        transcriptOffset: null,
+        transcriptLength: null,
+        entities: classification.entities,
+        decisions: classification.decisions,
+        openQuestions: classification.open,
+    };
+    const factSink = deps.factStore
+        ? { factStore: deps.factStore, facts: extractFacts(classification, id, startedAt) }
+        : null;
+    await deps.store.insertSession(record, deps.embedder, null, factSink);
+    return { id, status: "ingested", latencyMs: Date.now() - t0, confidence: classification.confidence };
+}
+//# sourceMappingURL=ingest-session.js.map

package/dist/core/ingest/ingest-session.js.map

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

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

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ */
+import type { ProviderRow } from "./provider-registry.js";
+export type FetchImpl = typeof fetch;
+export interface ListModelsOptions {
+    readonly apiKey?: string | null;
+    readonly fetchImpl?: FetchImpl;
+    readonly timeoutMs?: number;
+}
+export declare function listModels(provider: ProviderRow, opts?: ListModelsOptions): Promise<string[]>;