nlm-memory 0.4.0

package/dist/hook/stop-hook.js

@@ -0,0 +1,171 @@
+/**
+ * Claude Code Stop hook entrypoint for NLM.
+ *
+ * Fires after the model finishes a response. Scans the last assistant message
+ * in the transcript for substrings matching any session ID the recall hook
+ * surfaced this conversation (via the dedup memo). Each match becomes a
+ * citation event posted to the daemon at POST /api/recall/cite-event.
+ *
+ * Double duty:
+ *  - Per-recall useful_hit_rate metric (was the returned ID actually used?)
+ *  - Training-data substrate for a learned reranker (was_cited per query)
+ *
+ * Fail-open by design: any error yields a clean exit with no output. The
+ * Stop hook can never block Claude Code's response. The smoke test path
+ * succeeds even with missing transcript_path because the hook always logs
+ * a `kind:"stop"` line.
+ */
+import { pathToFileURL } from "node:url";
+import { appendFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { detectCitations, } from "../core/hook/citation-detect.js";
+import { loadSurfaced } from "../core/hook/memo.js";
+import { loadCited, recordCited } from "../core/hook/cite-memo.js";
+import { readAllAssistantTurns, } from "../core/hook/transcript.js";
+const RESPONSE_PREVIEW_CHARS = 200;
+const POST_TIMEOUT_MS = 1500;
+export async function runStopHook(input, deps) {
+    // stop_hook_active=true means Stop is firing again because a prior Stop
+    // hook returned control to the model. Skip to avoid double-counting.
+    if (input.stopHookActive) {
+        return {
+            conversationId: input.conversationId,
+            surfacedCount: 0,
+            citations: [],
+            responsePreview: "",
+            skipped: true,
+        };
+    }
+    const surfaced = loadSurfaced(input.conversationId);
+    if (surfaced.size === 0) {
+        return {
+            conversationId: input.conversationId,
+            surfacedCount: 0,
+            citations: [],
+            responsePreview: "",
+            skipped: false,
+        };
+    }
+    const turns = readAllAssistantTurns(input.transcriptPath);
+    if (turns.length === 0) {
+        return {
+            conversationId: input.conversationId,
+            surfacedCount: surfaced.size,
+            citations: [],
+            responsePreview: "",
+            skipped: false,
+        };
+    }
+    const allToolUses = [];
+    const textParts = [];
+    for (const turn of turns) {
+        if (turn.text)
+            textParts.push(turn.text);
+        for (const tu of turn.toolUses)
+            allToolUses.push(tu);
+    }
+    const unionText = textParts.join("\n");
+    const detected = detectCitations({
+        responseText: unionText,
+        toolUses: allToolUses,
+        surfacedIds: surfaced,
+    });
+    const alreadyCited = loadCited(input.conversationId);
+    const fresh = detected.filter((c) => !alreadyCited.has(c.id));
+    // Preview is the LAST turn's prose — that's what Edward saw when Stop
+    // fired. Stable substrate for the citation log even when detection
+    // ranges across earlier turns.
+    const lastText = turns[turns.length - 1]?.text ?? "";
+    const preview = lastText.slice(0, RESPONSE_PREVIEW_CHARS);
+    for (const c of fresh) {
+        try {
+            await deps.postCitation(input.conversationId, c.id, c.kind, preview);
+        }
+        catch {
+            // Daemon down or HTTP error — local memo update below still records
+            // the citation so we don't repost on the next Stop fire.
+        }
+    }
+    if (fresh.length > 0) {
+        recordCited(input.conversationId, fresh.map((c) => c.id));
+    }
+    return {
+        conversationId: input.conversationId,
+        surfacedCount: surfaced.size,
+        citations: fresh,
+        responsePreview: preview,
+        skipped: false,
+    };
+}
+function logPath() {
+    return process.env["NLM_HOOK_LOG"] ?? join(homedir(), ".nlm", "hook-log.jsonl");
+}
+function logStopResult(result) {
+    try {
+        const path = logPath();
+        mkdirSync(dirname(path), { recursive: true });
+        appendFileSync(path, `${JSON.stringify({
+            ts: new Date().toISOString(),
+            kind: "stop",
+            conversationId: result.conversationId,
+            surfacedCount: result.surfacedCount,
+            citedIds: result.citations.map((c) => c.id),
+            citationKinds: result.citations.map((c) => c.kind),
+            skipped: result.skipped,
+            mode: process.env["NLM_HOOK_MODE"] === "live" ? "live" : "shadow",
+        })}\n`, "utf8");
+    }
+    catch {
+        // Telemetry failure must never break the hook.
+    }
+}
+function readStdin() {
+    return new Promise((resolve) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => (data += chunk));
+        process.stdin.on("end", () => resolve(data));
+        process.stdin.on("error", () => resolve(data));
+    });
+}
+async function postCitationOverHttp(conversationId, citedId, kind, responsePreview) {
+    const port = process.env["NLM_PORT"] ?? "3940";
+    const url = `http://localhost:${port}/api/recall/cite-event`;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), POST_TIMEOUT_MS);
+    try {
+        await fetch(url, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+                conversation_id: conversationId,
+                cited_id: citedId,
+                kind,
+                response_preview: responsePreview,
+            }),
+            signal: controller.signal,
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function main() {
+    try {
+        const raw = await readStdin();
+        const payload = JSON.parse(raw);
+        const conversationId = typeof payload.session_id === "string" ? payload.session_id : "unknown";
+        const transcriptPath = typeof payload.transcript_path === "string" ? payload.transcript_path : "";
+        const stopHookActive = payload.stop_hook_active === true;
+        const result = await runStopHook({ conversationId, transcriptPath, stopHookActive }, { postCitation: postCitationOverHttp });
+        logStopResult(result);
+    }
+    catch {
+        // Fail open — never block Claude Code's response.
+    }
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    void main();
+}
+//# sourceMappingURL=stop-hook.js.map

package/dist/hook/stop-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-hook.js","sourceRoot":"","sources":["../../src/hook/stop-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,eAAe,GAEhB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EACL,qBAAqB,GAEtB,MAAM,0BAA0B,CAAC;AAElC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AACnC,MAAM,eAAe,GAAG,IAAI,CAAC;AA8B7B,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,KAAoB,EACpB,IAAqB;IAErB,wEAAwE;IACxE,qEAAqE;IACrE,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QACzB,OAAO;YACL,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,EAAE;YACb,eAAe,EAAE,EAAE;YACnB,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,aAAa,EAAE,CAAC;YAChB,SAAS,EAAE,EAAE;YACb,eAAe,EAAE,EAAE;YACnB,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,aAAa,EAAE,QAAQ,CAAC,IAAI;YAC5B,SAAS,EAAE,EAAE;YACb,eAAe,EAAE,EAAE;YACnB,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAmB,EAAE,CAAC;IACvC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,IAAI;YAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ;YAAE,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEvC,MAAM,QAAQ,GAAG,eAAe,CAAC;QAC/B,YAAY,EAAE,SAAS;QACvB,QAAQ,EAAE,WAAW;QACrB,WAAW,EAAE,QAAQ;KACtB,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9D,sEAAsE;IACtE,mEAAmE;IACnE,+BAA+B;IAC/B,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAE1D,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvE,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;YACpE,yDAAyD;QAC3D,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,WAAW,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO;QACL,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,aAAa,EAAE,QAAQ,CAAC,IAAI;QAC5B,SAAS,EAAE,KAAK;QAChB,eAAe,EAAE,OAAO;QACxB,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC;AAED,SAAS,OAAO;IACd,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,aAAa,CAAC,MAAsB;IAC3C,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;QACvB,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,cAAc,CACZ,IAAI,EACJ,GAAG,IAAI,CAAC,SAAS,CAAC;YAChB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC5B,IAAI,EAAE,MAAM;YACZ,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3C,aAAa,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAClD,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ;SAClE,CAAC,IAAI,EACN,MAAM,CACP,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,cAAsB,EACtB,OAAe,EACf,IAAkB,EAClB,eAAuB;IAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC;IAC/C,MAAM,GAAG,GAAG,oBAAoB,IAAI,wBAAwB,CAAC;IAC7D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,eAAe,CAAC,CAAC;IACpE,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,GAAG,EAAE;YACf,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,eAAe,EAAE,cAAc;gBAC/B,QAAQ,EAAE,OAAO;gBACjB,IAAI;gBACJ,gBAAgB,EAAE,eAAe;aAClC,CAAC;YACF,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;IACL,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAI7B,CAAC;QACF,MAAM,cAAc,GAClB,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,MAAM,cAAc,GAClB,OAAO,OAAO,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,MAAM,cAAc,GAAG,OAAO,CAAC,gBAAgB,KAAK,IAAI,CAAC;QAEzD,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,EAClD,EAAE,YAAY,EAAE,oBAAoB,EAAE,CACvC,CAAC;QACF,aAAa,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,kDAAkD;IACpD,CAAC;AACH,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/E,KAAK,IAAI,EAAE,CAAC;AACd,CAAC"}

package/dist/hook/subagent-start-hook.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Claude Code SubagentStart hook entrypoint for NLM.
+ *
+ * Fires when Claude Code dispatches a subagent (Agent tool). Subagents have
+ * their own session IDs but are invisible to NLM's session corpus today.
+ * This hook captures the parent→subagent link so NLM can correlate subagent
+ * transcripts back to the dispatching conversation when SessionEnd fires.
+ *
+ * Capture-only. No recall injection — subagents inherit context from their
+ * dispatch prompt; additional recall would pollute their narrow task scope.
+ *
+ * Daemon endpoint: POST localhost:3940/api/hook/subagent-start
+ * This endpoint does NOT exist yet in the daemon — the hook ships fail-soft
+ * (swallows errors). The daemon-side handler is a follow-up task.
+ *
+ * Payload: { parent_conversation_id, subagent_session_id, subagent_description, ts }
+ *
+ * Fail-open by design: any error yields a clean exit with no output.
+ */
+export interface SubagentStartInput {
+    readonly parentConversationId: string;
+    readonly subagentSessionId: string;
+    readonly subagentDescription: string;
+}
+export interface SubagentStartResult {
+    readonly parentConversationId: string;
+    readonly subagentSessionId: string;
+    readonly posted: boolean;
+}
+export declare function runSubagentStart(input: SubagentStartInput, portValue?: string): Promise<SubagentStartResult>;

package/dist/hook/subagent-start-hook.js

@@ -0,0 +1,108 @@
+/**
+ * Claude Code SubagentStart hook entrypoint for NLM.
+ *
+ * Fires when Claude Code dispatches a subagent (Agent tool). Subagents have
+ * their own session IDs but are invisible to NLM's session corpus today.
+ * This hook captures the parent→subagent link so NLM can correlate subagent
+ * transcripts back to the dispatching conversation when SessionEnd fires.
+ *
+ * Capture-only. No recall injection — subagents inherit context from their
+ * dispatch prompt; additional recall would pollute their narrow task scope.
+ *
+ * Daemon endpoint: POST localhost:3940/api/hook/subagent-start
+ * This endpoint does NOT exist yet in the daemon — the hook ships fail-soft
+ * (swallows errors). The daemon-side handler is a follow-up task.
+ *
+ * Payload: { parent_conversation_id, subagent_session_id, subagent_description, ts }
+ *
+ * Fail-open by design: any error yields a clean exit with no output.
+ */
+import { pathToFileURL } from "node:url";
+import { appendFileSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+const POST_TIMEOUT_MS = 1500;
+export async function runSubagentStart(input, portValue = process.env["NLM_PORT"] ?? "3940") {
+    const payload = {
+        parent_conversation_id: input.parentConversationId,
+        subagent_session_id: input.subagentSessionId,
+        subagent_description: input.subagentDescription,
+        ts: new Date().toISOString(),
+    };
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), POST_TIMEOUT_MS);
+    try {
+        const res = await fetch(`http://localhost:${portValue}/api/hook/subagent-start`, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify(payload),
+            signal: controller.signal,
+        });
+        return {
+            parentConversationId: input.parentConversationId,
+            subagentSessionId: input.subagentSessionId,
+            posted: res.ok,
+        };
+    }
+    catch {
+        // Endpoint absent or daemon down — fail soft, never block subagent dispatch.
+        return {
+            parentConversationId: input.parentConversationId,
+            subagentSessionId: input.subagentSessionId,
+            posted: false,
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function logPath() {
+    return process.env["NLM_HOOK_LOG"] ?? join(homedir(), ".nlm", "hook-log.jsonl");
+}
+function logResult(result) {
+    try {
+        const path = logPath();
+        mkdirSync(dirname(path), { recursive: true });
+        appendFileSync(path, `${JSON.stringify({
+            ts: new Date().toISOString(),
+            kind: "subagent-start",
+            parentConversationId: result.parentConversationId,
+            subagentSessionId: result.subagentSessionId,
+            posted: result.posted,
+        })}\n`, "utf8");
+    }
+    catch {
+        // Telemetry failure must never break the hook.
+    }
+}
+function readStdin() {
+    return new Promise((resolve) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => (data += chunk));
+        process.stdin.on("end", () => resolve(data));
+        process.stdin.on("error", () => resolve(data));
+    });
+}
+async function main() {
+    try {
+        const raw = await readStdin();
+        const payload = JSON.parse(raw);
+        const subagentSessionId = typeof payload.session_id === "string" ? payload.session_id : "unknown";
+        const parentConversationId = typeof payload.parent_session_id === "string" ? payload.parent_session_id : "unknown";
+        const subagentDescription = typeof payload.description === "string" ? payload.description : "";
+        const result = await runSubagentStart({
+            parentConversationId,
+            subagentSessionId,
+            subagentDescription,
+        });
+        logResult(result);
+    }
+    catch {
+        // Fail open — never block subagent dispatch.
+    }
+}
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+    void main();
+}
+//# sourceMappingURL=subagent-start-hook.js.map

package/dist/hook/subagent-start-hook.js.map

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

package/dist/http/app.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Hono app factory. Routes mirror the Python daemon's API surface (GET
+ * /api/recall, GET /api/recall/stats, GET /api/session/:id, GET /api/health)
+ * so existing UI clients and the agent-recall observability panel can switch
+ * to this server without contract changes.
+ *
+ * Layering: this module knows about RecallService and SessionStore (the
+ * inner ring), but core/ knows nothing about Hono. Adapter direction stays
+ * one-way.
+ *
+ * POST /mcp — Streamable-HTTP MCP endpoint for container agents (e.g. Hermes
+ * WebUI). Requires Authorization: Bearer <NLM_MCP_TOKEN>. Stateless: each
+ * request gets its own transport + server instance so there is no in-memory
+ * session state to manage. The existing stdio MCP path is untouched.
+ */
+import { Hono } from "hono";
+import type { RecallService } from "../core/recall/recall-service.js";
+import type { FactRecallService } from "../core/recall-facts/fact-recall-service.js";
+import type { FactStore } from "../ports/fact-store.js";
+import { ClassifierBox } from "../llm/classifier-box.js";
+import { SourceRegistry } from "../core/sources/source-registry.js";
+import { ProviderRegistry } from "../core/providers/provider-registry.js";
+import { type IngestDeps } from "../core/ingest/ingest-session.js";
+import type { SessionStore } from "../ports/session-store.js";
+import type { SqliteSessionStore } from "../core/storage/sqlite-session-store.js";
+import type { McpDeps } from "../mcp/server.js";
+export interface HttpDeps {
+    readonly recall: RecallService;
+    readonly store: SessionStore;
+    /** Pass the concrete store when /live endpoints (recent-writes / recent-markers) should be served. */
+    readonly liveStore?: SqliteSessionStore;
+    /** Optional override for the query log path. Defaults to ~/.nlm/query_log.jsonl or $NLM_QUERY_LOG. */
+    readonly queryLogPath?: string;
+    /** Optional override for the citation log path. Defaults to ~/.nlm/citation-log.jsonl or $NLM_CITATION_LOG. */
+    readonly citationLogPath?: string;
+    /** Fact recall — wire to enable /api/recall/facts + /api/facts/history. */
+    readonly factRecall?: FactRecallService;
+    readonly factStore?: FactStore;
+    /** Optional override for the fact query log path. Defaults to ~/.nlm/fact_query_log.jsonl. */
+    readonly factQueryLogPath?: string;
+    /** Path to canonical.sqlite for the /api/dataset endpoint. */
+    readonly dbPath?: string;
+    /** Mutable classifier — read by /api/classifier/info, swapped by POST /api/classifier. */
+    readonly classifier?: ClassifierBox;
+    /** Sources registry — exposes /api/sources CRUD for the desktop UI. */
+    readonly sources?: SourceRegistry;
+    /** Providers registry — exposes /api/providers CRUD for the desktop UI. */
+    readonly providers?: ProviderRegistry;
+    /** Wire to enable POST /api/ingest. When omitted, push ingest is disabled. */
+    readonly ingest?: IngestDeps;
+    /** Static embedder info — embeddings are always Ollama in this build (DeepSeek has no /embed). */
+    readonly embedderInfo?: {
+        provider: string;
+        model: string;
+        dims: number;
+    };
+    /** Directory containing the built UI (dist/ui). When set, /ui/* serves the SPA. */
+    readonly uiDist?: string;
+    /**
+     * When provided, POST /mcp is mounted and token-gated with NLM_MCP_TOKEN.
+     * Omitting this keeps the route absent — no auth surface, no risk.
+     */
+    readonly mcpDeps?: McpDeps;
+}
+export declare function createApp(deps: HttpDeps): Hono;