nlm-memory 0.4.0

package/dist/core/adapters/opencode.js

@@ -0,0 +1,213 @@
+/**
+ * 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 { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import Database from "better-sqlite3";
+import { durationMinutes, normalizeTimestamp } from "./common.js";
+const TOOL_OUTPUT_PREVIEW_CHARS = 240;
+export function defaultDbPath() {
+    if (process.env["OPENCODE_DB_PATH"])
+        return process.env["OPENCODE_DB_PATH"];
+    if (process.platform === "darwin") {
+        return join(homedir(), "Library", "Application Support", "opencode", "opencode.db");
+    }
+    const xdg = process.env["XDG_DATA_HOME"] ?? join(homedir(), ".local", "share");
+    return join(xdg, "opencode", "opencode.db");
+}
+function readGitBranch(directory) {
+    try {
+        const head = readFileSync(join(directory, ".git", "HEAD"), "utf8").trim();
+        const match = /^ref: refs\/heads\/(.+)$/.exec(head);
+        return match ? (match[1] ?? "") : "";
+    }
+    catch {
+        return "";
+    }
+}
+function extractTurns(messages, partsByMessage) {
+    const turns = [];
+    for (const msg of messages) {
+        let info;
+        try {
+            info = JSON.parse(msg.data);
+        }
+        catch {
+            continue;
+        }
+        if (info.role !== "user" && info.role !== "assistant")
+            continue;
+        const parts = partsByMessage.get(msg.id) ?? [];
+        const segments = [];
+        for (const p of parts) {
+            if (p.type === "text") {
+                const tp = p;
+                if (!tp.ignored && tp.text)
+                    segments.push(tp.text);
+            }
+            else if (p.type === "tool") {
+                const tp = p;
+                const output = extractToolOutput(tp);
+                segments.push(output ? `[tool: ${tp.tool}] ${output}` : `[tool: ${tp.tool}]`);
+            }
+        }
+        const text = segments.join("\n").trim();
+        if (!text)
+            continue;
+        turns.push({ role: info.role, text, timestamp: normalizeTimestamp(msg.time_created) });
+    }
+    return turns;
+}
+function extractToolOutput(part) {
+    const state = part.state;
+    if (!state)
+        return "";
+    const output = state["output"] ??
+        state["result"] ??
+        "";
+    if (typeof output !== "string" || !output)
+        return "";
+    const preview = output.slice(0, TOOL_OUTPUT_PREVIEW_CHARS);
+    return output.length > TOOL_OUTPUT_PREVIEW_CHARS ? `${preview}…` : preview;
+}
+function provisionalLabel(turns) {
+    for (const t of turns) {
+        if (t.role !== "user")
+            continue;
+        const first = t.text.split("\n", 1)[0]?.trim();
+        if (first)
+            return first.slice(0, 80);
+    }
+    return "Untitled session";
+}
+export class OpenCodeAdapter {
+    name = "opencode";
+    runtimeVersion = "opencode/1.0";
+    transcriptKind = "opencode-sqlite";
+    dbPath;
+    constructor(opts = {}) {
+        this.dbPath = opts.dbPath ?? defaultDbPath();
+    }
+    detect() {
+        if (existsSync(this.dbPath)) {
+            return { adapterName: this.name, enabled: true, path: this.dbPath, hint: null };
+        }
+        return { adapterName: this.name, enabled: false, path: null, hint: "opencode.db not found" };
+    }
+    async discover(options) {
+        if (!existsSync(this.dbPath))
+            return [];
+        let db;
+        try {
+            db = new Database(this.dbPath, { readonly: true });
+            let rows;
+            if (options?.since) {
+                const sinceMs = options.since.getTime();
+                rows = db
+                    .prepare(`SELECT id FROM session WHERE time_archived IS NULL AND time_updated >= ?`)
+                    .all(sinceMs);
+            }
+            else {
+                rows = db
+                    .prepare(`SELECT id FROM session WHERE time_archived IS NULL`)
+                    .all();
+            }
+            return rows.map((r) => r.id);
+        }
+        catch {
+            return [];
+        }
+        finally {
+            db?.close();
+        }
+    }
+    async parseSession(sessionId) {
+        if (!existsSync(this.dbPath))
+            return null;
+        let db;
+        try {
+            db = new Database(this.dbPath, { readonly: true });
+            const session = db
+                .prepare(`SELECT id, directory, title, time_created, time_updated
+           FROM session WHERE id = ?`)
+                .get(sessionId);
+            if (!session)
+                return null;
+            const messages = db
+                .prepare(`SELECT id, time_created, data FROM message
+           WHERE session_id = ? ORDER BY time_created ASC`)
+                .all(sessionId);
+            const partRows = db
+                .prepare(`SELECT message_id, time_created, data FROM part
+           WHERE session_id = ? ORDER BY time_created ASC`)
+                .all(sessionId);
+            const partsByMessage = new Map();
+            for (const row of partRows) {
+                let data;
+                try {
+                    data = JSON.parse(row.data);
+                }
+                catch {
+                    continue;
+                }
+                const bucket = partsByMessage.get(row.message_id);
+                if (bucket) {
+                    bucket.push(data);
+                }
+                else {
+                    partsByMessage.set(row.message_id, [data]);
+                }
+            }
+            const turns = extractTurns(messages, partsByMessage);
+            if (turns.length === 0)
+                return null;
+            const startedAt = normalizeTimestamp(session.time_created);
+            const endedAt = normalizeTimestamp(session.time_updated);
+            const transcript = turns.map((t) => `${t.role}: ${t.text}`).join("\n\n");
+            const label = session.title && session.title !== "New session"
+                ? session.title.slice(0, 80)
+                : provisionalLabel(turns);
+            return {
+                id: `oc_${sessionId}`,
+                runtime: this.runtimeVersion,
+                runtimeSessionId: sessionId,
+                sourcePath: `${this.dbPath}::${sessionId}`,
+                startedAt,
+                endedAt,
+                durationMin: durationMinutes(startedAt, endedAt),
+                turnCount: turns.length,
+                byteRange: [0, Buffer.byteLength(transcript, "utf8")],
+                projectDir: session.directory,
+                gitBranch: readGitBranch(session.directory),
+                text: transcript,
+                label,
+            };
+        }
+        catch {
+            return null;
+        }
+        finally {
+            db?.close();
+        }
+    }
+}
+//# sourceMappingURL=opencode.js.map

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

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

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

@@ -0,0 +1,32 @@
+/**
+ * Pi adapter.
+ *
+ * Reads ~/.pi/agent/sessions/<cwd-slug>/<timestamp>_<uuid>.jsonl. Pi writes
+ * session files even when a run aborts — those still ingest, but the adapter
+ * flags them via the `gitBranch: "aborted"` sentinel (SessionChunk has no
+ * status field; storage layer decodes the sentinel later).
+ *
+ * File shape (v3, confirmed 2026-05-18): one JSON object per line. Five
+ * event types: session, model_change, thinking_level_change, message,
+ * custom_message. Only `message` produces turns; the rest are configuration
+ * or extension-injected (custom_message must be excluded).
+ *
+ * Discovery is recursive (`<sessions>/<cwd-slug>/<file>.jsonl`).
+ * $PI_SESSIONS_PATH overrides the default path.
+ */
+import type { DetectionResult, DiscoverOptions, SessionChunk, TranscriptAdapter } from "../../ports/transcript-adapter.js";
+export interface PiAdapterOptions {
+    readonly sessionsPath?: string;
+    readonly idleMinutes?: number;
+}
+export declare class PiAdapter implements TranscriptAdapter {
+    readonly name = "pi";
+    readonly runtimeVersion = "pi/1.0";
+    readonly transcriptKind = "pi-jsonl";
+    private readonly sessionsPath;
+    readonly idleMinutes: number;
+    constructor(opts?: PiAdapterOptions);
+    detect(): DetectionResult;
+    discover(options?: DiscoverOptions): Promise<ReadonlyArray<string>>;
+    parseSession(path: string): Promise<SessionChunk | null>;
+}

package/dist/core/adapters/pi.js

@@ -0,0 +1,233 @@
+/**
+ * Pi adapter.
+ *
+ * Reads ~/.pi/agent/sessions/<cwd-slug>/<timestamp>_<uuid>.jsonl. Pi writes
+ * session files even when a run aborts — those still ingest, but the adapter
+ * flags them via the `gitBranch: "aborted"` sentinel (SessionChunk has no
+ * status field; storage layer decodes the sentinel later).
+ *
+ * File shape (v3, confirmed 2026-05-18): one JSON object per line. Five
+ * event types: session, model_change, thinking_level_change, message,
+ * custom_message. Only `message` produces turns; the rest are configuration
+ * or extension-injected (custom_message must be excluded).
+ *
+ * Discovery is recursive (`<sessions>/<cwd-slug>/<file>.jsonl`).
+ * $PI_SESSIONS_PATH overrides the default path.
+ */
+import { promises as fs, existsSync, statSync } from "node:fs";
+import { extname, join } from "node:path";
+import { homedir } from "node:os";
+import { durationMinutes, normalizeTimestamp, safeSessionId, } from "./common.js";
+const TOOL_RESULT_PREVIEW_CHARS = 240;
+function defaultSessionsPath() {
+    return (process.env["PI_SESSIONS_PATH"] ??
+        join(homedir(), ".pi", "agent", "sessions"));
+}
+export class PiAdapter {
+    name = "pi";
+    runtimeVersion = "pi/1.0";
+    transcriptKind = "pi-jsonl";
+    sessionsPath;
+    idleMinutes;
+    constructor(opts = {}) {
+        this.sessionsPath = opts.sessionsPath ?? defaultSessionsPath();
+        this.idleMinutes = opts.idleMinutes ?? 15;
+    }
+    detect() {
+        const p = defaultSessionsPath();
+        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: "Pi not detected — ~/.pi/agent/sessions/ missing.",
+        };
+    }
+    async discover(options = {}) {
+        if (!existsSync(this.sessionsPath))
+            return [];
+        const found = [];
+        await walk(this.sessionsPath, async (full, st) => {
+            if (st.size === 0)
+                return;
+            if (extname(full) !== ".jsonl")
+                return;
+            if (options.since && st.mtime < options.since)
+                return;
+            found.push({ mtime: st.mtimeMs, path: full });
+        });
+        found.sort((a, b) => a.mtime - b.mtime);
+        return found.map((f) => f.path);
+    }
+    async parseSession(path) {
+        let raw;
+        try {
+            raw = await fs.readFile(path, "utf8");
+        }
+        catch {
+            return null;
+        }
+        const turns = [];
+        let sessionId = "";
+        let projectDir = "";
+        let startedAt = "";
+        let endedAt = "";
+        let totalBytes = 0;
+        let allAssistantErrors = true;
+        for (const line of raw.split("\n")) {
+            totalBytes += Buffer.byteLength(line, "utf8") + 1;
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            let evt;
+            try {
+                evt = JSON.parse(trimmed);
+            }
+            catch {
+                continue;
+            }
+            const evtType = evt["type"];
+            if (evtType === "session") {
+                if (typeof evt["id"] === "string")
+                    sessionId = evt["id"];
+                if (typeof evt["cwd"] === "string")
+                    projectDir = evt["cwd"];
+                continue;
+            }
+            if (evtType === "model_change" ||
+                evtType === "thinking_level_change" ||
+                evtType === "custom_message") {
+                continue;
+            }
+            if (evtType !== "message")
+                continue;
+            const msg = isRecord(evt["message"]) ? evt["message"] : {};
+            const role = msg["role"];
+            if (role !== "user" && role !== "assistant")
+                continue;
+            const innerTs = msg["timestamp"];
+            const outerTs = evt["timestamp"];
+            const ts = innerTs
+                ? normalizeTimestamp(innerTs)
+                : normalizeTimestamp(outerTs);
+            if (ts) {
+                if (!startedAt)
+                    startedAt = ts;
+                endedAt = ts;
+            }
+            const text = extractPiText(msg["content"]);
+            if (role === "assistant") {
+                const stop = typeof msg["stopReason"] === "string" ? msg["stopReason"] : "";
+                if (stop !== "error")
+                    allAssistantErrors = false;
+                if (!text.trim())
+                    continue; // error turns have empty content
+            }
+            else if (!text.trim()) {
+                continue;
+            }
+            turns.push({ role, text, timestamp: ts });
+        }
+        if (turns.length === 0)
+            return null;
+        const hasUser = turns.some((t) => t.role === "user");
+        const hasSuccessfulAssistant = turns.some((t) => t.role === "assistant");
+        const isAborted = hasUser && (!hasSuccessfulAssistant || allAssistantErrors);
+        const transcript = turns.map((t) => `[${t.role}] ${t.text}`).join("\n\n");
+        const duration = durationMinutes(startedAt, endedAt);
+        const label = provisionalLabel(turns);
+        const rawId = sessionId || path.split("/").pop().replace(".jsonl", "");
+        return {
+            id: safeSessionId("pi", rawId),
+            runtime: this.runtimeVersion,
+            runtimeSessionId: rawId,
+            sourcePath: path,
+            startedAt,
+            endedAt,
+            durationMin: duration,
+            turnCount: turns.length,
+            byteRange: [0, totalBytes],
+            projectDir,
+            gitBranch: isAborted ? "aborted" : "",
+            text: transcript,
+            label,
+        };
+    }
+}
+// ── helpers ──────────────────────────────────────────────────────────────
+function isRecord(v) {
+    return !!v && typeof v === "object" && !Array.isArray(v);
+}
+async function walk(dir, onFile) {
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const ent of entries) {
+        const full = join(dir, ent.name);
+        if (ent.isDirectory()) {
+            await walk(full, onFile);
+        }
+        else if (ent.isFile()) {
+            try {
+                const st = await fs.stat(full);
+                await onFile(full, st);
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+}
+function extractPiText(content) {
+    if (typeof content === "string")
+        return content.trim();
+    if (!Array.isArray(content))
+        return "";
+    const parts = [];
+    for (const block of content) {
+        if (!isRecord(block))
+            continue;
+        const btype = block["type"];
+        if (btype === "text") {
+            const t = block["text"];
+            if (typeof t === "string" && t.trim())
+                parts.push(t.trim());
+        }
+        else if (btype === "tool_use") {
+            const name = typeof block["name"] === "string" ? block["name"] : "tool";
+            parts.push(`[tool_use: ${name}]`);
+        }
+        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}]`);
+            }
+        }
+    }
+    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=pi.js.map

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

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

package/dist/core/classifier/prompt.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Classifier prompt + transcript helpers. Centralized so every LLMClient
+ * implementation hits the same prompt (parity with the Python daemon).
+ *
+ * Hard cap at 15K chars matches `classifier.py` MAX_TRANSCRIPT_CHARS:
+ * smaller models (phi4-mini, qwen) pattern-match JSON from the transcript
+ * above that size. Long sessions get first-half + last-half with a
+ * separator to preserve opening intent + closing decisions.
+ *
+ * Phase B.2: prompt now also asks for a `facts` array of normalized
+ * (subject, predicate, value) triples for the FactStore. The closed
+ * predicate vocabulary is embedded in the prompt so deterministic
+ * supersedence (Phase B.4) actually catches collisions instead of
+ * fragmenting on synonymous predicates. See docs/plans/factstore-design.md.
+ */
+/**
+ * Closed predicate vocabulary. Approximately 25 high-leverage predicates
+ * covering the most common (subject, predicate, value) shapes Edward
+ * actually writes about in sessions.
+ *
+ * Vocab evolution (Phase B.5 backfill, 2026-05-19): the 168-session pilot
+ * showed `other` getting used 43% of the time — it became a catch-all for
+ * narrative observations that don't fit the (subject, predicate, value)
+ * shape at all. Removed. The classifier prompt now instructs the model to
+ * SKIP facts that don't fit (leave them in decisions[]/open[] instead).
+ * Added `description`, `commit`, `cost` from observed high-frequency
+ * patterns in the pilot batch's `other` bucket.
+ *
+ * Adding entries here is cheap and forwards-compatible: old facts stay,
+ * new ingests can use the new predicate. Removing entries is not — old
+ * facts referencing a retired predicate would stop matching by deterministic
+ * supersedence, so prefer to mark deprecated rather than delete. (Existing
+ * `other`-predicate facts from the pilot stay in the DB and are filterable
+ * at query time; the coercer will drop new `other` writes.)
+ */
+export declare const PREDICATE_VOCABULARY: readonly ["framework", "endpoint", "model", "port", "host", "owner", "pricing", "cost", "deadline", "status", "stack", "runtime", "library", "version", "dependency", "schema", "integration", "deployment", "repo", "branch", "commit", "description", "decided-on", "assumption", "blocker"];
+export type PredicateVocab = (typeof PREDICATE_VOCABULARY)[number];
+export declare const CLASSIFIER_SYSTEM_PROMPT: string;
+export declare const MAX_TRANSCRIPT_CHARS = 15000;
+export declare function truncateTranscript(text: string, maxChars?: number): string;
+export declare function stripJsonFences(text: string): string;
+export declare function validateClassifierJson(data: unknown): data is Record<string, unknown>;
+export declare function buildUserPrompt(transcript: string, priorContext: string): string;
+interface CoercedFact {
+    kind: "decision" | "open" | "attribute";
+    subject: string;
+    predicate: string;
+    value: string;
+    sourceQuote?: string;
+}
+export declare function coerceClassifyResult(data: Record<string, unknown>): {
+    label: string;
+    summary: string;
+    entities: string[];
+    decisions: string[];
+    open: string[];
+    confidence: number;
+    facts: CoercedFact[];
+};
+export {};