nlm-memory 0.4.0

package/dist/core/adapters/hermes-agent.js.map

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

package/dist/core/adapters/hermes.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Hermes adapter.
+ *
+ * Reads ~/.hermes/sessions/*.json files. Two file shapes coexist:
+ *
+ *   session_<date>_<id>.json     — live session format
+ *     { session_id, model, session_start, last_updated, messages: [...] }
+ *
+ *   request_dump_<date>_<id>_<date>_<time>.json  — error-dump format
+ *     { timestamp, session_id, request: { body: { messages: [...] } } }
+ *
+ * Discovery dedupes by `session_id`: when both shapes exist for the same
+ * session (failure case), the live `session_` file wins because it carries
+ * richer metadata.
+ */
+import type { DetectionResult, DiscoverOptions, SessionChunk, TranscriptAdapter } from "../../ports/transcript-adapter.js";
+export interface HermesAdapterOptions {
+    readonly sessionsPath?: string;
+    readonly idleMinutes?: number;
+}
+export declare class HermesAdapter implements TranscriptAdapter {
+    readonly name = "hermes";
+    readonly runtimeVersion = "hermes/1.0";
+    readonly transcriptKind = "hermes-json";
+    private readonly sessionsPath;
+    readonly idleMinutes: number;
+    constructor(opts?: HermesAdapterOptions);
+    detect(): DetectionResult;
+    discover(options?: DiscoverOptions): Promise<ReadonlyArray<string>>;
+    parseSession(path: string): Promise<SessionChunk | null>;
+}

package/dist/core/adapters/hermes.js

@@ -0,0 +1,247 @@
+/**
+ * Hermes adapter.
+ *
+ * Reads ~/.hermes/sessions/*.json files. Two file shapes coexist:
+ *
+ *   session_<date>_<id>.json     — live session format
+ *     { session_id, model, session_start, last_updated, messages: [...] }
+ *
+ *   request_dump_<date>_<id>_<date>_<time>.json  — error-dump format
+ *     { timestamp, session_id, request: { body: { messages: [...] } } }
+ *
+ * Discovery dedupes by `session_id`: when both shapes exist for the same
+ * session (failure case), the live `session_` file wins because it carries
+ * richer metadata.
+ */
+import { promises as fs, existsSync, statSync } from "node:fs";
+import { basename, extname, join } from "node:path";
+import { homedir } from "node:os";
+import { durationMinutes, normalizeTimestamp, safeSessionId, } from "./common.js";
+const TOOL_RESULT_PREVIEW_CHARS = 200;
+export class HermesAdapter {
+    name = "hermes";
+    runtimeVersion = "hermes/1.0";
+    transcriptKind = "hermes-json";
+    sessionsPath;
+    idleMinutes;
+    constructor(opts = {}) {
+        this.sessionsPath =
+            opts.sessionsPath ?? join(homedir(), ".hermes", "sessions");
+        this.idleMinutes = opts.idleMinutes ?? 30;
+    }
+    detect() {
+        const p = join(homedir(), ".hermes", "sessions");
+        if (existsSync(p) && statSync(p).isDirectory()) {
+            return { adapterName: this.name, enabled: true, path: p, hint: null };
+        }
+        return {
+            adapterName: this.name,
+            enabled: false,
+            path: null,
+            hint: "Hermes not detected — ~/.hermes/sessions/ missing.",
+        };
+    }
+    async discover(options = {}) {
+        if (!existsSync(this.sessionsPath))
+            return [];
+        const allFiles = [];
+        const entries = await fs.readdir(this.sessionsPath, { withFileTypes: true });
+        for (const ent of entries) {
+            if (!ent.isFile() || extname(ent.name) !== ".json")
+                continue;
+            const full = join(this.sessionsPath, ent.name);
+            const st = await fs.stat(full);
+            if (st.size === 0)
+                continue;
+            allFiles.push(full);
+        }
+        // Build session_id → {session, dump} map, preferring session_ files.
+        const bySid = new Map();
+        for (const jf of allFiles) {
+            let data;
+            try {
+                const raw = await fs.readFile(jf, "utf8");
+                data = JSON.parse(raw);
+            }
+            catch {
+                continue;
+            }
+            const sidVal = data["session_id"];
+            const sid = typeof sidVal === "string" && sidVal ? sidVal : basename(jf, ".json");
+            const hasMessages = "messages" in data && !("request" in data);
+            const slot = hasMessages ? "session" : "dump";
+            const cur = bySid.get(sid) ?? {};
+            cur[slot] = jf;
+            bySid.set(sid, cur);
+        }
+        const chosen = [];
+        for (const variants of bySid.values()) {
+            const canonical = variants.session ?? variants.dump;
+            if (!canonical)
+                continue;
+            const st = await fs.stat(canonical);
+            if (options.since && st.mtime < options.since)
+                continue;
+            chosen.push({ mtime: st.mtimeMs, path: canonical });
+        }
+        chosen.sort((a, b) => a.mtime - b.mtime);
+        return chosen.map((c) => c.path);
+    }
+    async parseSession(path) {
+        let data;
+        try {
+            const raw = await fs.readFile(path, "utf8");
+            data = JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+        let totalBytes = 0;
+        try {
+            totalBytes = (await fs.stat(path)).size;
+        }
+        catch {
+            return null;
+        }
+        let msgs;
+        let sessionId;
+        let fileStartedAt;
+        let fileEndedAt;
+        if ("messages" in data && !isRecord(data["request"])) {
+            // Live session format
+            msgs = Array.isArray(data["messages"]) ? data["messages"] : [];
+            sessionId =
+                typeof data["session_id"] === "string" && data["session_id"]
+                    ? data["session_id"]
+                    : basename(path, ".json");
+            fileStartedAt =
+                typeof data["session_start"] === "string" ? data["session_start"] : "";
+            fileEndedAt =
+                typeof data["last_updated"] === "string" ? data["last_updated"] : "";
+        }
+        else {
+            // Request dump format
+            const body = isRecord(data["request"]) && isRecord(data["request"]["body"])
+                ? data["request"]["body"]
+                : {};
+            msgs = Array.isArray(body["messages"]) ? body["messages"] : [];
+            sessionId =
+                typeof data["session_id"] === "string" && data["session_id"]
+                    ? data["session_id"]
+                    : basename(path, ".json");
+            const ts = typeof data["timestamp"] === "string" ? data["timestamp"] : "";
+            fileStartedAt = ts;
+            fileEndedAt = ts;
+        }
+        if (msgs.length === 0)
+            return null;
+        fileStartedAt = normalizeTimestamp(fileStartedAt);
+        fileEndedAt = normalizeTimestamp(fileEndedAt);
+        const turns = [];
+        let firstTs = "";
+        let lastTs = "";
+        for (const m of msgs) {
+            if (!isRecord(m))
+                continue;
+            const role = typeof m["role"] === "string" ? m["role"] : "";
+            if (!role || role === "system")
+                continue;
+            const toolCalls = Array.isArray(m["tool_calls"])
+                ? m["tool_calls"]
+                : null;
+            const text = extractHermesText(m["content"], toolCalls);
+            if (!text.trim())
+                continue;
+            const msgTs = normalizeTimestamp(m["timestamp"]);
+            if (msgTs) {
+                if (!firstTs)
+                    firstTs = msgTs;
+                lastTs = msgTs;
+            }
+            turns.push({ role, text, timestamp: msgTs });
+        }
+        if (turns.length === 0)
+            return null;
+        if (!firstTs && fileStartedAt)
+            firstTs = fileStartedAt;
+        if (!lastTs && fileEndedAt)
+            lastTs = fileEndedAt;
+        const transcript = turns.map((t) => `[${t.role}] ${t.text}`).join("\n\n");
+        const duration = durationMinutes(firstTs, lastTs);
+        const label = provisionalLabel(turns);
+        return {
+            id: safeSessionId("hm", sessionId),
+            runtime: this.runtimeVersion,
+            runtimeSessionId: sessionId,
+            sourcePath: path,
+            startedAt: firstTs,
+            endedAt: lastTs,
+            durationMin: duration,
+            turnCount: turns.length,
+            byteRange: [0, totalBytes],
+            projectDir: "",
+            gitBranch: "",
+            text: transcript,
+            label,
+        };
+    }
+}
+// ── helpers ──────────────────────────────────────────────────────────────
+function isRecord(v) {
+    return !!v && typeof v === "object" && !Array.isArray(v);
+}
+function extractHermesText(content, toolCalls) {
+    const parts = [];
+    if (typeof content === "string") {
+        const t = content.trim();
+        if (t)
+            parts.push(t);
+    }
+    else if (Array.isArray(content)) {
+        for (const block of content) {
+            if (!isRecord(block))
+                continue;
+            const btype = block["type"];
+            if (btype === "text") {
+                const txt = block["text"];
+                if (typeof txt === "string" && txt.trim())
+                    parts.push(txt.trim());
+            }
+            else if (btype === "tool_result") {
+                let res = block["content"];
+                if (Array.isArray(res)) {
+                    res = res
+                        .filter(isRecord)
+                        .map((b) => (typeof b["text"] === "string" ? b["text"] : ""))
+                        .join("\n");
+                }
+                if (typeof res === "string" && res) {
+                    const preview = res.slice(0, TOOL_RESULT_PREVIEW_CHARS);
+                    const ellipsis = res.length > TOOL_RESULT_PREVIEW_CHARS ? "…" : "";
+                    parts.push(`[tool_result: ${preview}${ellipsis}]`);
+                }
+            }
+        }
+    }
+    if (toolCalls) {
+        for (const tc of toolCalls) {
+            if (!isRecord(tc))
+                continue;
+            const fn = isRecord(tc["function"]) ? tc["function"] : {};
+            const name = typeof fn["name"] === "string" ? fn["name"] : "tool";
+            parts.push(`[tool_use: ${name}]`);
+        }
+    }
+    return parts.filter((p) => p).join("\n");
+}
+function provisionalLabel(turns) {
+    for (const t of turns) {
+        if (t.role !== "user")
+            continue;
+        const firstLine = t.text.split("\n", 1)[0]?.trim();
+        if (firstLine)
+            return firstLine.slice(0, 80);
+    }
+    return "Untitled session";
+}
+//# sourceMappingURL=hermes.js.map

package/dist/core/adapters/hermes.js.map

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

package/dist/core/adapters/jsonl-generic.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Generic JSONL adapter — driven by per-source `parseConfig`.
+ *
+ * Reads any directory of newline-delimited JSON files where each line is one
+ * conversation turn. The three baked-in adapters (claude-code, hermes, pi)
+ * stay as their own classes because each has format-specific quirks that
+ * would bloat a generic config schema. This adapter exists for everything
+ * else: Cursor, Codex, custom logs, anything a user can drop on disk in a
+ * consistent shape.
+ *
+ * parseConfig shape (all optional except where noted):
+ *   {
+ *     "textField":         "content",     // required — the message body
+ *     "roleField":         "role",        // optional — "user"/"assistant" filter
+ *     "userRole":          "user",        // string the user role takes
+ *     "assistantRole":     "assistant",   // string the assistant role takes
+ *     "timestampField":    "timestamp",   // optional — ISO or unix
+ *     "sessionIdField":    "session_id",  // optional — falls back to filename
+ *     "labelField":        "title",       // optional — falls back to filename
+ *     "filePattern":       "*.jsonl",     // glob within pathOrUrl
+ *     "idleMinutes":       15
+ *   }
+ */
+import type { DetectionResult, DiscoverOptions, SessionChunk, TranscriptAdapter } from "../../ports/transcript-adapter.js";
+export interface JsonlGenericConfig {
+    readonly textField?: string;
+    readonly roleField?: string;
+    readonly userRole?: string;
+    readonly assistantRole?: string;
+    readonly timestampField?: string;
+    readonly sessionIdField?: string;
+    readonly labelField?: string;
+    readonly filePattern?: string;
+    readonly idleMinutes?: number;
+}
+export interface JsonlGenericAdapterOptions {
+    readonly name: string;
+    readonly path: string;
+    readonly runtime: string;
+    readonly config: JsonlGenericConfig;
+}
+export declare class JsonlGenericAdapter implements TranscriptAdapter {
+    readonly name: string;
+    readonly runtimeVersion: string;
+    readonly transcriptKind = "jsonl-generic";
+    readonly idleMinutes: number;
+    private readonly path;
+    private readonly cfg;
+    constructor(opts: JsonlGenericAdapterOptions);
+    detect(): DetectionResult;
+    discover(options?: DiscoverOptions): Promise<ReadonlyArray<string>>;
+    parseSession(filePath: string): Promise<SessionChunk | null>;
+    private classifyRole;
+    private extractText;
+    private extOfPattern;
+}

package/dist/core/adapters/jsonl-generic.js

@@ -0,0 +1,185 @@
+/**
+ * Generic JSONL adapter — driven by per-source `parseConfig`.
+ *
+ * Reads any directory of newline-delimited JSON files where each line is one
+ * conversation turn. The three baked-in adapters (claude-code, hermes, pi)
+ * stay as their own classes because each has format-specific quirks that
+ * would bloat a generic config schema. This adapter exists for everything
+ * else: Cursor, Codex, custom logs, anything a user can drop on disk in a
+ * consistent shape.
+ *
+ * parseConfig shape (all optional except where noted):
+ *   {
+ *     "textField":         "content",     // required — the message body
+ *     "roleField":         "role",        // optional — "user"/"assistant" filter
+ *     "userRole":          "user",        // string the user role takes
+ *     "assistantRole":     "assistant",   // string the assistant role takes
+ *     "timestampField":    "timestamp",   // optional — ISO or unix
+ *     "sessionIdField":    "session_id",  // optional — falls back to filename
+ *     "labelField":        "title",       // optional — falls back to filename
+ *     "filePattern":       "*.jsonl",     // glob within pathOrUrl
+ *     "idleMinutes":       15
+ *   }
+ */
+import { promises as fs, existsSync, statSync } from "node:fs";
+import { basename, extname, join } from "node:path";
+import { durationMinutes, normalizeTimestamp, safeSessionId } from "./common.js";
+export class JsonlGenericAdapter {
+    name;
+    runtimeVersion;
+    transcriptKind = "jsonl-generic";
+    idleMinutes;
+    path;
+    cfg;
+    constructor(opts) {
+        this.name = opts.name;
+        this.runtimeVersion = opts.runtime;
+        this.path = opts.path;
+        this.idleMinutes = opts.config.idleMinutes ?? 15;
+        this.cfg = {
+            textField: opts.config.textField ?? "content",
+            roleField: opts.config.roleField ?? "role",
+            userRole: opts.config.userRole ?? "user",
+            assistantRole: opts.config.assistantRole ?? "assistant",
+            timestampField: opts.config.timestampField ?? "timestamp",
+            sessionIdField: opts.config.sessionIdField ?? "session_id",
+            labelField: opts.config.labelField ?? "title",
+            filePattern: opts.config.filePattern ?? "*.jsonl",
+        };
+    }
+    detect() {
+        if (existsSync(this.path) && statSync(this.path).isDirectory()) {
+            return { adapterName: this.name, enabled: true, path: this.path, hint: null };
+        }
+        return {
+            adapterName: this.name,
+            enabled: false,
+            path: null,
+            hint: `${this.name}: directory not found at ${this.path}`,
+        };
+    }
+    async discover(options = {}) {
+        if (!existsSync(this.path))
+            return [];
+        const entries = await fs.readdir(this.path, { withFileTypes: true });
+        const wantExt = this.extOfPattern(this.cfg.filePattern);
+        const out = [];
+        for (const e of entries) {
+            if (!e.isFile())
+                continue;
+            if (wantExt && extname(e.name) !== wantExt)
+                continue;
+            const full = join(this.path, e.name);
+            if (options.since) {
+                const st = statSync(full);
+                if (st.mtime < options.since)
+                    continue;
+            }
+            out.push(full);
+        }
+        return out;
+    }
+    async parseSession(filePath) {
+        let raw;
+        try {
+            raw = await fs.readFile(filePath, "utf8");
+        }
+        catch {
+            return null;
+        }
+        const lines = raw.split("\n").filter((l) => l.trim().length > 0);
+        if (lines.length === 0)
+            return null;
+        const turns = [];
+        let sessionIdFromRows = null;
+        let labelFromRows = null;
+        for (const line of lines) {
+            let row;
+            try {
+                row = JSON.parse(line);
+            }
+            catch {
+                continue;
+            }
+            if (!sessionIdFromRows && typeof row[this.cfg.sessionIdField] === "string") {
+                sessionIdFromRows = row[this.cfg.sessionIdField];
+            }
+            if (!labelFromRows && typeof row[this.cfg.labelField] === "string") {
+                labelFromRows = row[this.cfg.labelField];
+            }
+            const role = this.classifyRole(row[this.cfg.roleField]);
+            if (!role)
+                continue;
+            const text = this.extractText(row[this.cfg.textField]);
+            if (!text)
+                continue;
+            turns.push({
+                role,
+                text,
+                timestamp: normalizeTimestamp(row[this.cfg.timestampField]),
+            });
+        }
+        if (turns.length === 0)
+            return null;
+        const startedAt = turns[0]?.timestamp ?? "";
+        const endedAt = turns[turns.length - 1]?.timestamp ?? startedAt;
+        const fileName = basename(filePath, extname(filePath));
+        const rawId = sessionIdFromRows ?? fileName;
+        const label = labelFromRows ?? fileName;
+        const text = turns
+            .map((t) => `${t.role === "user" ? "User" : "Assistant"}: ${t.text}`)
+            .join("\n\n");
+        return {
+            id: safeSessionId(this.name, rawId),
+            runtime: this.runtimeVersion,
+            runtimeSessionId: rawId,
+            sourcePath: filePath,
+            startedAt,
+            endedAt,
+            durationMin: durationMinutes(startedAt, endedAt),
+            turnCount: turns.length,
+            byteRange: [0, Buffer.byteLength(raw)],
+            projectDir: this.path,
+            gitBranch: "",
+            text,
+            label,
+        };
+    }
+    classifyRole(raw) {
+        if (raw === undefined || raw === null) {
+            // Some formats omit the field — assume alternating; bias to assistant.
+            return "assistant";
+        }
+        if (typeof raw !== "string")
+            return null;
+        if (raw === this.cfg.userRole)
+            return "user";
+        if (raw === this.cfg.assistantRole)
+            return "assistant";
+        return null;
+    }
+    extractText(raw) {
+        if (typeof raw === "string")
+            return raw.trim();
+        if (Array.isArray(raw)) {
+            // OpenAI-style content: [{ type: "text", text: "..." }, ...]
+            const parts = [];
+            for (const item of raw) {
+                if (typeof item === "string")
+                    parts.push(item);
+                else if (item && typeof item === "object" && typeof item.text === "string") {
+                    parts.push(item.text);
+                }
+            }
+            return parts.join(" ").trim();
+        }
+        return "";
+    }
+    extOfPattern(pattern) {
+        const idx = pattern.lastIndexOf(".");
+        if (idx < 0)
+            return null;
+        return pattern.slice(idx);
+    }
+}
+//# sourceMappingURL=jsonl-generic.js.map

package/dist/core/adapters/jsonl-generic.js.map

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

package/dist/core/adapters/opencode.d.ts

@@ -0,0 +1,36 @@
+/**
+ * OpenCode adapter.
+ *
+ * Reads the OpenCode SQLite database at:
+ *   macOS: ~/Library/Application Support/opencode/opencode.db
+ *   Linux: $XDG_DATA_HOME/opencode/opencode.db (default ~/.local/share/opencode/opencode.db)
+ *
+ * Unlike the JSONL-based adapters, OpenCode stores all sessions and messages
+ * in a single SQLite file. `discover()` queries the sessions table and returns
+ * session IDs (not file paths). `parseSession()` treats its string argument as
+ * a session ID and reconstructs a SessionChunk from the messages and parts tables.
+ *
+ * Part types extracted:
+ *   - text  (non-ignored): the conversational prose
+ *   - tool  : summarized as [tool: <name>]
+ *   All other part types (reasoning, step-start/finish, snapshot, patch,
+ *   compaction, agent, retry, subtask) are structural and skipped.
+ *
+ * Format reference: verified against sst/opencode migration
+ * 20260127222353_familiar_lady_ursula and session.sql.ts, 2026-05-28.
+ */
+import type { DetectionResult, DiscoverOptions, SessionChunk, TranscriptAdapter } from "../../ports/transcript-adapter.js";
+export interface OpenCodeAdapterOptions {
+    readonly dbPath?: string;
+}
+export declare function defaultDbPath(): string;
+export declare class OpenCodeAdapter implements TranscriptAdapter {
+    readonly name = "opencode";
+    readonly runtimeVersion = "opencode/1.0";
+    readonly transcriptKind = "opencode-sqlite";
+    private readonly dbPath;
+    constructor(opts?: OpenCodeAdapterOptions);
+    detect(): DetectionResult;
+    discover(options?: DiscoverOptions): Promise<ReadonlyArray<string>>;
+    parseSession(sessionId: string): Promise<SessionChunk | null>;
+}