@nookplot/mcp 0.4.113 → 0.4.115

package/dist/syncSessions.js

@@ -0,0 +1,260 @@
+/**
+ * Phase 2b — session post-processor.
+ *
+ * `nookplot-mcp sync-sessions` walks `~/.hermes/sessions/session_*.json`,
+ * finds sessions we haven't processed yet, extracts findings + reasoning
+ * traces heuristically, and POSTs each to the Phase 2c capture queue at
+ * `/v1/me/captures`. Each POST goes through the same sybil gate +
+ * ContentScanner + rate-limit that the realtime MCP tools already use —
+ * this file is a thin driver, not a new write surface.
+ *
+ * Safety net positioning:
+ *   - The MCP tools in Phase 2a run DURING the session; this subcommand
+ *     runs AFTER. Together they ensure that even if the agent forgot to
+ *     call `nookplot_capture_finding` during work, the synthesis it
+ *     produced doesn't get lost.
+ *   - Everything goes through the 24h review queue, so the user can
+ *     still reject anything the heuristic misidentified as a finding.
+ *   - Dedup is two-layered: `processed_sessions.json` skips whole
+ *     sessions on the next run, and the gateway's UNIQUE (agent_address,
+ *     kind, content_hash) index blocks exact-duplicate bodies across
+ *     different sessions too.
+ *
+ * @module syncSessions
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { extractFromSession } from "./syncSessionsExtractor.js";
+import { defaultStatePath, isSessionProcessed, isItemAlreadyCaptured, loadState, markSessionProcessed, saveState, } from "./syncSessionsState.js";
+// ---------------------------------------------------------------------------
+//  File discovery
+// ---------------------------------------------------------------------------
+/**
+ * Default sessions directory. Tests override via `opts.sessionsDir`; in
+ * production this is where Hermes v0.8.0 writes session JSONs.
+ */
+function defaultSessionsDir() {
+    return join(homedir(), ".hermes", "sessions");
+}
+/**
+ * Session files are named `session_<YYYYMMDD>_<HHMMSS>_<hex>.json`.
+ * We ignore `request_dump_*.json` (Hermes's per-request snapshots) since
+ * those are noisy duplicates of the session data with much more tool
+ * metadata — we only want the clean session stream.
+ */
+function isSessionFile(filename) {
+    return /^session_\d{8}_\d{6}_[a-f0-9]+\.json$/.test(filename);
+}
+/**
+ * Extract a stable session id from a Hermes session file. We prefer the
+ * in-file `session_id` (which Hermes guarantees unique per chat) but
+ * fall back to the filename-derived id if the file is malformed.
+ */
+function sessionIdOf(session, filename) {
+    if (typeof session.session_id === "string" && session.session_id.length > 0) {
+        return session.session_id;
+    }
+    // filename is `session_<id>.json`, strip the prefix + suffix.
+    return filename.replace(/^session_/, "").replace(/\.json$/, "");
+}
+// ---------------------------------------------------------------------------
+//  Gateway POST
+// ---------------------------------------------------------------------------
+/**
+ * Send one extracted item to the gateway's capture queue. Returns the
+ * queue row id on success, an error string on failure.
+ *
+ * We deliberately tolerate the gateway responding with a "duplicate"
+ * path — `POST /v1/me/captures` is idempotent per the Phase 2c design
+ * (same content-hash returns the existing row), so a re-run of
+ * `sync-sessions` that hits an already-captured item is NOT an error.
+ */
+async function postCapture(opts, gatewayUrl, item, sessionId, agentAddress) {
+    const fetchFn = opts._fetch ?? fetch;
+    const timeoutMs = opts.timeoutMs ?? 15_000;
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const res = await fetchFn(`${gatewayUrl.replace(/\/$/, "")}/v1/me/captures`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${opts.credentials.apiKey}`,
+            },
+            body: JSON.stringify({
+                kind: item.kind,
+                payload: item.payload,
+                agentAddress,
+                sourceSessionId: sessionId,
+            }),
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const body = await res.text().catch(() => "");
+            return {
+                error: `HTTP ${res.status}: ${body.slice(0, 200)}`,
+            };
+        }
+        const parsed = (await res.json());
+        if (typeof parsed.id !== "string") {
+            return { error: "Gateway response missing `id` field" };
+        }
+        return { captureId: parsed.id };
+    }
+    catch (err) {
+        return { error: err instanceof Error ? err.message : String(err) };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+// ---------------------------------------------------------------------------
+//  Orchestration
+// ---------------------------------------------------------------------------
+/**
+ * Main entry point. Walks sessions, extracts, posts. Returns a summary
+ * caller can print. Tests drive this directly with mocked `_fetch` +
+ * `sessionsDir` + `statePath`.
+ */
+export async function syncSessions(opts) {
+    const gatewayUrl = opts.gatewayUrl ??
+        process.env.NOOKPLOT_GATEWAY_URL ??
+        "https://gateway.nookplot.com";
+    const sessionsDir = opts.sessionsDir ?? defaultSessionsDir();
+    const statePath = opts.statePath ?? defaultStatePath();
+    const limit = opts.limit ?? 10;
+    const scopedAgentAddress = opts.scopedAgentAddress ?? process.env.NOOKPLOT_AGENT_ADDRESS ?? undefined;
+    const result = {
+        inspected: 0,
+        processed: 0,
+        skipped: 0,
+        failed: 0,
+        capturesCreated: 0,
+        perSession: [],
+    };
+    if (!existsSync(sessionsDir)) {
+        // Fresh install — no sessions yet. Not an error, just nothing to do.
+        return result;
+    }
+    let state = loadState(statePath);
+    // Sort files oldest → newest so resumed runs process in chronological
+    // order, matching the natural "replay of the user's work" semantics.
+    const files = readdirSync(sessionsDir)
+        .filter(isSessionFile)
+        .map((name) => {
+        const full = join(sessionsDir, name);
+        const stat = statSync(full);
+        return { name, full, mtimeMs: stat.mtimeMs };
+    })
+        .sort((a, b) => a.mtimeMs - b.mtimeMs);
+    for (const file of files) {
+        if (result.processed >= limit)
+            break;
+        result.inspected += 1;
+        // --since filter: skip anything older than the cutoff.
+        if (opts.since && file.mtimeMs < opts.since.getTime()) {
+            result.skipped += 1;
+            result.perSession.push({
+                sessionId: file.name,
+                filePath: file.full,
+                status: "skipped",
+                extracted: 0,
+                captured: 0,
+                errors: [],
+                skipReason: "older than --since cutoff",
+            });
+            continue;
+        }
+        // Parse the session.
+        let session;
+        try {
+            const raw = readFileSync(file.full, "utf8");
+            session = JSON.parse(raw);
+        }
+        catch (err) {
+            result.failed += 1;
+            result.perSession.push({
+                sessionId: file.name,
+                filePath: file.full,
+                status: "failed",
+                extracted: 0,
+                captured: 0,
+                errors: [
+                    `parse: ${err instanceof Error ? err.message : String(err)}`,
+                ],
+            });
+            continue;
+        }
+        const sid = sessionIdOf(session, file.name);
+        // Already-processed fast path. --force bypasses this but still dedups
+        // on the item level below, so we never double-POST known items.
+        if (!opts.force && isSessionProcessed(state, sid)) {
+            result.skipped += 1;
+            result.perSession.push({
+                sessionId: sid,
+                filePath: file.full,
+                status: "skipped",
+                extracted: 0,
+                captured: 0,
+                errors: [],
+                skipReason: "already processed (use --force to reprocess)",
+            });
+            continue;
+        }
+        const extracted = extractFromSession(session);
+        const itemResults = [];
+        const errors = [];
+        let captured = 0;
+        for (const item of extracted) {
+            // Item-level dedup for --force re-runs: if we know the gateway
+            // already has this hash from a prior pass, skip the POST entirely.
+            if (opts.force && isItemAlreadyCaptured(state, sid, item.hash)) {
+                captured += 1; // count it as already-captured for the summary
+                continue;
+            }
+            if (opts.dryRun) {
+                itemResults.push({ hash: item.hash, kind: item.kind });
+                captured += 1;
+                continue;
+            }
+            const postResult = await postCapture(opts, gatewayUrl, item, sid, scopedAgentAddress);
+            if ("captureId" in postResult) {
+                itemResults.push({
+                    hash: item.hash,
+                    kind: item.kind,
+                    captureId: postResult.captureId,
+                });
+                captured += 1;
+            }
+            else {
+                itemResults.push({
+                    hash: item.hash,
+                    kind: item.kind,
+                    error: postResult.error,
+                });
+                errors.push(`${item.kind}: ${postResult.error}`);
+            }
+        }
+        // Record this session (successes + failures) so we don't re-process.
+        // Failures are still recorded: on the next run we skip the whole
+        // session unless --force is used. If the user wants to retry just
+        // the failed items they run with --force.
+        if (!opts.dryRun) {
+            state = markSessionProcessed(state, sid, itemResults);
+            saveState(state, statePath);
+        }
+        result.processed += 1;
+        result.capturesCreated += captured;
+        result.perSession.push({
+            sessionId: sid,
+            filePath: file.full,
+            status: "processed",
+            extracted: extracted.length,
+            captured,
+            errors,
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=syncSessions.js.map

package/dist/syncSessions.js.map

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

package/dist/syncSessionsExtractor.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Phase 2b — heuristic extractor for Hermes session files.
+ *
+ * Given a parsed Hermes session JSON (shape observed in
+ * `~/.hermes/sessions/session_*.json`), produces a list of
+ * capture-queue-ready items without calling an LLM. The LLM path is
+ * intentionally deferred — the plan suggests using the user's configured
+ * provider, but:
+ *
+ *   - Shipping an extractor with zero external deps means `sync-sessions`
+ *     just works the moment it's installed, no BYOK setup required.
+ *   - Heuristic misses are caught by the gateway's quality gate +
+ *     ContentScanner, so low-value captures don't pollute the KG.
+ *   - The code below is structured around a pure function
+ *     `extractFromSession(sessionJson) -> ExtractedItem[]`, so the LLM
+ *     strategy can slot in later behind the same interface.
+ *
+ * Heuristic rules (conservative on purpose — we'd rather under-capture
+ * than spam the review queue):
+ *
+ *   - A FINDING is extracted when a session has ≥2 tool-call turns
+ *     followed by an assistant text turn. The final assistant text is
+ *     the body; the first user message is the title / taskSummary.
+ *   - A REASONING TRACE is extracted when a session has ≥2 assistant
+ *     text turns interleaved with tool calls. Each text turn becomes a
+ *     step; the last becomes the conclusion.
+ *   - Body must be ≥200 chars for findings, ≥50 for conclusions.
+ *     Shorter syntheses aren't worth queuing.
+ *   - Tool-call outputs are NEVER used as the body — only the assistant's
+ *     own text. This is the Phase 2d §6 mitigation against session
+ *     transcript poisoning.
+ *
+ * @module syncSessionsExtractor
+ */
+/** One message from a Hermes session `messages[]` array. */
+export interface HermesMessage {
+    role: "user" | "assistant" | "tool" | "system";
+    content?: string | null;
+    /** Present on assistant turns that invoked tools. */
+    tool_calls?: Array<{
+        id?: string;
+        type?: string;
+        function?: {
+            name?: string;
+            arguments?: string;
+        };
+    }>;
+    /** Present on `tool` turns, referring back to the assistant's call. */
+    tool_call_id?: string;
+    /** Present on `tool` turns — the tool that produced the result. */
+    name?: string;
+}
+/** The subset of a Hermes session file we care about. */
+export interface HermesSession {
+    session_id?: string;
+    model?: string;
+    messages?: HermesMessage[];
+    session_start?: string;
+    last_updated?: string;
+}
+/**
+ * What we extract. Shape mirrors the `payload` field the capture-queue
+ * endpoint expects, plus a `kind` discriminator + a content hash we use
+ * for local dedup.
+ */
+export type ExtractedItem = {
+    kind: "finding";
+    hash: string;
+    payload: {
+        title: string;
+        body: string;
+        sources?: string[];
+        domain?: string;
+        tags?: string[];
+    };
+} | {
+    kind: "reasoning";
+    hash: string;
+    payload: {
+        taskSummary: string;
+        steps: Array<{
+            step: string;
+            rationale?: string;
+        }>;
+        conclusion: string;
+        modelUsed?: string;
+    };
+};
+/**
+ * Extract a FINDING from a session that researched + synthesized.
+ *
+ * Preconditions checked inside:
+ *   - ≥2 tool-call invocations (otherwise it's a trivial lookup, not a finding)
+ *   - Final assistant text is ≥200 chars
+ *   - There's a user prompt to use as the title
+ *
+ * Returns `null` if the session doesn't pattern-match. That's the common
+ * case — most sessions are one-shot Q&A, not research.
+ */
+export declare function extractFindingHeuristic(session: HermesSession): ExtractedItem | null;
+/**
+ * Extract a REASONING TRACE from a session with multi-step thinking.
+ *
+ * Preconditions:
+ *   - ≥2 non-empty assistant text turns (steps + conclusion)
+ *   - ≥2 tool-call invocations OR total message count ≥ 5 (so a
+ *     pure-text chat-of-thought still qualifies if it had structure)
+ *   - Conclusion length ≥50 chars
+ *
+ * The `steps` array is built from every assistant text turn EXCEPT the
+ * last one. The last becomes the `conclusion`. If there's only one text
+ * turn, we bail — single-step "reasoning" is just a finding.
+ */
+export declare function extractReasoningHeuristic(session: HermesSession): ExtractedItem | null;
+/**
+ * Main extraction entry point. Runs both extractors and returns every
+ * item that matched. It is valid for a single session to yield both a
+ * finding AND a reasoning trace — research sessions that pivoted midway
+ * have both a synthesis (the finding) and a process worth remembering
+ * (the reasoning trace). The gateway dedup guards prevent actual dupes.
+ */
+export declare function extractFromSession(session: HermesSession): ExtractedItem[];
+//# sourceMappingURL=syncSessionsExtractor.d.ts.map

package/dist/syncSessionsExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncSessionsExtractor.d.ts","sourceRoot":"","sources":["../src/syncSessionsExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AASH,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qDAAqD;IACrD,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE;YAAE,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAClD,CAAC,CAAC;IACH,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,yDAAyD;AACzD,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;KACjB,CAAC;CACH,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACnD,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH,CAAC;AAyNN;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,GAAG,IAAI,CA0CpF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,GAAG,IAAI,CAyCtF;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,EAAE,CAO1E"}