@supersession/sup 0.1.3 → 0.1.4

package/dist/engine.js

@@ -5,19 +5,18 @@
  * over stdout, so a stray console.log would corrupt the protocol. Callers get
  * structured results and decide how (or whether) to print them.
  */
-import { findClaudeCodeSession } from "./discover.js";
-import { parseClaudeCode } from "./parsers/claude-code.js";
+import { findLatestSession } from "./discover.js";
 import { redactSession } from "./redact.js";
 import { distillTemplate } from "./distill/template.js";
 import { distillSmart } from "./distill/smart.js";
 export class NoSessionError extends Error {
 }
-/** Parse the latest Claude Code session for a directory, or throw NoSessionError. */
+/** Parse the newest session (any supported tool) for a directory, or throw. */
 export function requireSession(cwd) {
-    const found = findClaudeCodeSession(cwd);
+    const found = findLatestSession(cwd);
     if (!found)
-        throw new NoSessionError(`No Claude Code session found for ${cwd} (looked under ~/.claude/projects).`);
-    const parsed = parseClaudeCode(found.filePath);
+        throw new NoSessionError(`No session found for ${cwd} (looked for Claude Code, Codex, and Cursor sessions).`);
+    const parsed = found.parse();
     if (parsed.turns.length === 0)
         throw new NoSessionError("Session file had no usable turns.");
     return parsed;

package/dist/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAc,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAE5C,qFAAqF;AACrF,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK;QACR,MAAM,IAAI,cAAc,CAAC,oCAAoC,GAAG,qCAAqC,CAAC,CAAC;IACzG,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,mCAAmC,CAAC,CAAC;IAC7F,OAAO,MAAM,CAAC;AAChB,CAAC;AASD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAe,EACf,aAAsB;IAEtB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACxF,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,OAAO;QAClB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,KAAK;YACL,CAAC,CAAC,8BAA8B,KAAK,0BAA0B;YAC/D,CAAC,CAAC,wGAAwG,CAAC;IAC/G,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC"}
+{"version":3,"file":"engine.js","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAc,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,OAAO,cAAe,SAAQ,KAAK;CAAG;AAE5C,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK;QACR,MAAM,IAAI,cAAc,CACtB,wBAAwB,GAAG,wDAAwD,CACpF,CAAC;IACJ,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;IAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,cAAc,CAAC,mCAAmC,CAAC,CAAC;IAC7F,OAAO,MAAM,CAAC;AAChB,CAAC;AASD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAe,EACf,aAAsB;IAEtB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,EAAE,KAAK,EAAE,eAAe,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACxF,CAAC;IACD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;IACzF,MAAM,IAAI,GAAG,OAAO;QAClB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,KAAK;YACL,CAAC,CAAC,8BAA8B,KAAK,0BAA0B;YAC/D,CAAC,CAAC,wGAAwG,CAAC;IAC/G,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/facts.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `sup facts` — extract the nuggets people scroll transcripts hunting for:
+ * credentials the agent generated, URLs and ports, and credential-ish prose
+ * lines ("your test login is admin@x.com / hunter2").
+ *
+ * LOCAL ONLY. This module is the mirror image of redact.ts: redaction strips
+ * secrets before anything leaves the machine; facts surfaces them ON the
+ * machine. Nothing here is ever pushed, written to a brief, or logged remotely.
+ */
+import type { NsfSession } from "./nsf.js";
+export interface Fact {
+    /** What was found (secret value, URL, or a verbatim prose line). */
+    value: string;
+    /** Category detail, e.g. "github-token" or "credential mention". */
+    label: string;
+    /** 1-based turn number, so the user can find it in context. */
+    turn: number;
+}
+export interface SessionFacts {
+    secrets: Fact[];
+    urls: Fact[];
+    credentialLines: Fact[];
+}
+export declare function extractFacts(session: NsfSession): SessionFacts;

package/dist/facts.js

@@ -0,0 +1,56 @@
+/**
+ * `sup facts` — extract the nuggets people scroll transcripts hunting for:
+ * credentials the agent generated, URLs and ports, and credential-ish prose
+ * lines ("your test login is admin@x.com / hunter2").
+ *
+ * LOCAL ONLY. This module is the mirror image of redact.ts: redaction strips
+ * secrets before anything leaves the machine; facts surfaces them ON the
+ * machine. Nothing here is ever pushed, written to a brief, or logged remotely.
+ */
+import { findSecrets } from "./redact.js";
+const URL_RE = /\bhttps?:\/\/[^\s)"'`<>\]]+/g;
+// Bare host:port the way dev servers get mentioned ("listening on localhost:3000").
+// The lookbehind keeps it from double-reporting the host inside an http:// URL.
+const HOSTPORT_RE = /(?<![/.\w])(?:localhost|127\.0\.0\.1|0\.0\.0\.0):\d{2,5}\b/g;
+// Prose lines that talk about credentials without matching a key pattern.
+const CRED_LINE_RE = /\b(password|passwd|username|user ?name|login|credentials?|api ?key|access ?token)\b/i;
+/** Dedupe by value, keeping the first (earliest turn) occurrence. */
+function dedupe(facts) {
+    const seen = new Set();
+    return facts.filter((f) => (seen.has(f.value) ? false : (seen.add(f.value), true)));
+}
+export function extractFacts(session) {
+    const secrets = [];
+    const urls = [];
+    const credentialLines = [];
+    session.turns.forEach((t, i) => {
+        const turn = i + 1;
+        const texts = [t.text, ...t.actions.map((a) => a.command ?? "")].filter(Boolean);
+        for (const text of texts) {
+            for (const hit of findSecrets(text))
+                secrets.push({ value: hit.value, label: hit.name, turn });
+            for (const m of text.matchAll(URL_RE)) {
+                // Trailing punctuation is sentence noise, not part of the URL.
+                urls.push({ value: m[0].replace(/[.,;:!?]+$/, ""), label: "url", turn });
+            }
+            for (const m of text.matchAll(HOSTPORT_RE))
+                urls.push({ value: m[0], label: "port", turn });
+        }
+        // Credential mentions: only assistant prose (that's where "your login is…"
+        // lives), line-by-line so the printed fact reads in context.
+        if (t.role === "assistant" && t.text) {
+            for (const line of t.text.split("\n")) {
+                const trimmed = line.trim();
+                if (trimmed && CRED_LINE_RE.test(trimmed)) {
+                    credentialLines.push({ value: trimmed.slice(0, 160), label: "credential mention", turn });
+                }
+            }
+        }
+    });
+    return {
+        secrets: dedupe(secrets),
+        urls: dedupe(urls),
+        credentialLines: dedupe(credentialLines),
+    };
+}
+//# sourceMappingURL=facts.js.map

package/dist/facts.js.map

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

package/dist/nsf.d.ts

@@ -40,6 +40,8 @@ export interface NsfProvenance {
     tool: string;
     /** The tool's native session id. */
     sessionId?: string;
+    /** Human title the source tool gave this session (e.g. Cursor's chat name). */
+    title?: string;
     /** Absolute working directory the session ran in. */
     cwd?: string;
     /** Git branch recorded at capture time, if any. */

package/dist/parsers/codex.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Codex CLI parser: rollout JSONL -> NSF.
+ *
+ * Grounded in the upstream format (verified 2026-07-15 against openai/codex
+ * codex-rs rollout recorder test fixtures), not a guess:
+ *   - Files live at ~/.codex/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl
+ *   - Each line: { timestamp, type, payload } (+ optional ordinal)
+ *   - type "session_meta": payload has session_id/id, cwd, source; sibling
+ *     `git` object may carry the branch.
+ *   - type "response_item": payload is tagged by payload.type:
+ *       "message"        { role, content: [{type:"input_text"|"output_text", text}] }
+ *       "function_call"  { name, arguments (JSON string), call_id }
+ *       "local_shell_call" { status, action: { command: [...] } }
+ *       "reasoning", "function_call_output", ... -> gaps
+ *   - type "event_msg" duplicates messages as UI events -> counted as gaps so
+ *     turns aren't doubled.
+ *   - type "compacted" is Codex's lossy in-place summarization -> a scar.
+ */
+import type { NsfSession } from "../nsf.js";
+export declare const CODEX_TOOL_ID = "codex";
+/**
+ * Parse a Codex rollout JSONL file into NSF.
+ * @param filePath absolute path to the rollout-*.jsonl transcript.
+ */
+export declare function parseCodex(filePath: string): NsfSession;

package/dist/parsers/codex.js

@@ -0,0 +1,212 @@
+/**
+ * Codex CLI parser: rollout JSONL -> NSF.
+ *
+ * Grounded in the upstream format (verified 2026-07-15 against openai/codex
+ * codex-rs rollout recorder test fixtures), not a guess:
+ *   - Files live at ~/.codex/sessions/YYYY/MM/DD/rollout-<ts>-<uuid>.jsonl
+ *   - Each line: { timestamp, type, payload } (+ optional ordinal)
+ *   - type "session_meta": payload has session_id/id, cwd, source; sibling
+ *     `git` object may carry the branch.
+ *   - type "response_item": payload is tagged by payload.type:
+ *       "message"        { role, content: [{type:"input_text"|"output_text", text}] }
+ *       "function_call"  { name, arguments (JSON string), call_id }
+ *       "local_shell_call" { status, action: { command: [...] } }
+ *       "reasoning", "function_call_output", ... -> gaps
+ *   - type "event_msg" duplicates messages as UI events -> counted as gaps so
+ *     turns aren't doubled.
+ *   - type "compacted" is Codex's lossy in-place summarization -> a scar.
+ */
+import { readFileSync } from "node:fs";
+import { NSF_VERSION } from "../nsf.js";
+export const CODEX_TOOL_ID = "codex";
+/** Codex injects wrapped context as fake user messages; they aren't the user. */
+const INJECTED_USER_RE = /^<(user_instructions|environment_context|ENVIRONMENT_CONTEXT)/i;
+function contentText(content) {
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .map((c) => {
+        const o = c;
+        return (o?.type === "input_text" || o?.type === "output_text") && typeof o.text === "string"
+            ? o.text
+            : "";
+    })
+        .filter(Boolean)
+        .join("\n\n")
+        .trim();
+}
+/** Best-effort shell command out of function_call arguments / shell action. */
+function commandFrom(args) {
+    if (typeof args !== "object" || args === null)
+        return undefined;
+    const cmd = args.command ?? args.cmd;
+    if (typeof cmd === "string")
+        return cmd;
+    if (Array.isArray(cmd))
+        return cmd.filter((x) => typeof x === "string").join(" ");
+    return undefined;
+}
+/** Paths named in an apply_patch envelope ("*** Update File: src/x.ts" etc). */
+function patchPaths(patch) {
+    const out = [];
+    for (const m of patch.matchAll(/^\*\*\* (?:Update|Add|Delete) File: (.+)$/gm)) {
+        out.push(m[1].trim());
+    }
+    return out;
+}
+function functionCallActions(name, rawArguments) {
+    let args = rawArguments;
+    if (typeof rawArguments === "string") {
+        try {
+            args = JSON.parse(rawArguments);
+        }
+        catch {
+            args = undefined;
+        }
+    }
+    const o = (typeof args === "object" && args !== null ? args : {});
+    if (name === "apply_patch") {
+        const patch = typeof o.input === "string" ? o.input : typeof rawArguments === "string" ? rawArguments : "";
+        const paths = patchPaths(patch);
+        if (paths.length === 0)
+            return [{ kind: "edit", rawName: name }];
+        return paths.map((path) => ({ kind: "edit", rawName: name, path }));
+    }
+    const path = typeof o.path === "string" ? o.path : typeof o.file_path === "string" ? o.file_path : undefined;
+    const command = commandFrom(o);
+    const kind = /shell|exec/.test(name)
+        ? "run"
+        : /read|view/.test(name)
+            ? "read"
+            : /write|create/.test(name)
+                ? "write"
+                : /search|grep|glob|find/.test(name)
+                    ? "search"
+                    : "other";
+    return [{ kind, rawName: name, path, command }];
+}
+/**
+ * Parse a Codex rollout JSONL file into NSF.
+ * @param filePath absolute path to the rollout-*.jsonl transcript.
+ */
+export function parseCodex(filePath) {
+    const raw = readFileSync(filePath, "utf8");
+    const turns = [];
+    const filesSeen = new Set();
+    const filesOrdered = [];
+    const gapCounts = new Map();
+    const addGap = (reason) => gapCounts.set(reason, (gapCounts.get(reason) ?? 0) + 1);
+    const provenance = {
+        tool: CODEX_TOOL_ID,
+        rawBytes: Buffer.byteLength(raw, "utf8"),
+    };
+    let compactions = 0;
+    // function_call actions attach to the pending assistant turn (Codex records
+    // calls as separate lines, unlike Claude Code's in-message blocks).
+    let pendingActions = [];
+    const flushActions = () => {
+        if (pendingActions.length === 0)
+            return;
+        turns.push({ role: "assistant", text: "", actions: pendingActions });
+        pendingActions = [];
+    };
+    for (const line of raw.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let rec;
+        try {
+            rec = JSON.parse(trimmed);
+        }
+        catch {
+            addGap("unparseable line");
+            continue;
+        }
+        const payload = rec.payload ?? {};
+        switch (rec.type) {
+            case "session_meta": {
+                const id = payload.id ?? payload.session_id;
+                provenance.sessionId ??= typeof id === "string" ? id : undefined;
+                provenance.cwd ??= typeof payload.cwd === "string" ? payload.cwd : undefined;
+                const git = rec.git ?? payload.git;
+                const branch = git?.branch;
+                provenance.gitBranch ??= typeof branch === "string" ? branch : undefined;
+                break;
+            }
+            case "compacted":
+                compactions++;
+                addGap("compaction/summary event");
+                break;
+            case "response_item": {
+                const ptype = payload.type;
+                if (ptype === "message") {
+                    const role = payload.role === "user" ? "user" : payload.role === "assistant" ? "assistant" : undefined;
+                    const text = contentText(payload.content);
+                    if (!role || !text) {
+                        addGap("empty turn");
+                        break;
+                    }
+                    if (role === "user" && INJECTED_USER_RE.test(text)) {
+                        addGap("injected context message");
+                        break;
+                    }
+                    if (role === "assistant" && pendingActions.length > 0) {
+                        // Attach the actions Codex logged since the last prose turn.
+                        turns.push({
+                            role,
+                            text,
+                            actions: pendingActions,
+                            timestamp: rec.timestamp ? Date.parse(rec.timestamp) : undefined,
+                        });
+                        pendingActions = [];
+                    }
+                    else {
+                        flushActions();
+                        turns.push({
+                            role,
+                            text,
+                            actions: [],
+                            timestamp: rec.timestamp ? Date.parse(rec.timestamp) : undefined,
+                        });
+                    }
+                }
+                else if (ptype === "function_call") {
+                    const name = typeof payload.name === "string" ? payload.name : "unknown";
+                    const actions = functionCallActions(name, payload.arguments);
+                    pendingActions.push(...actions);
+                    for (const a of actions) {
+                        if (a.path && !filesSeen.has(a.path)) {
+                            filesSeen.add(a.path);
+                            filesOrdered.push(a.path);
+                        }
+                    }
+                }
+                else if (ptype === "local_shell_call") {
+                    const command = commandFrom(payload.action);
+                    pendingActions.push({ kind: "run", rawName: "local_shell_call", command });
+                }
+                else {
+                    addGap(`non-conversational response item (${String(ptype ?? "unknown")})`);
+                }
+                break;
+            }
+            case "event_msg":
+                // Duplicates of message content as UI events — skip to avoid doubled turns.
+                addGap("ui event record");
+                break;
+            default:
+                addGap(`non-message record (${rec.type ?? "unknown"})`);
+        }
+    }
+    flushActions();
+    provenance.compactions = compactions;
+    const gaps = [...gapCounts.entries()].map(([reason, count]) => ({ reason, count }));
+    return {
+        nsfVersion: NSF_VERSION,
+        provenance,
+        turns,
+        filesTouched: filesOrdered,
+        gaps,
+    };
+}
+//# sourceMappingURL=codex.js.map

package/dist/parsers/codex.js.map

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

package/dist/parsers/cursor.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Cursor parser: global state.vscdb (SQLite) -> NSF.
+ *
+ * Grounded in the REAL on-disk schema (verified 2026-07-15 against a live
+ * Cursor install), not a guess:
+ *   - DB: <appdata>/Cursor/User/globalStorage/state.vscdb
+ *   - Table `composerHeaders` (composerId, workspaceId, lastUpdatedAt,
+ *     isSubagent, recency, value JSON) — value carries `name` (the chat title),
+ *     `workspaceIdentifier.uri.fsPath` (cwd) and `trackedGitRepos[].branches`.
+ *   - Table `cursorDiskKV`:
+ *       key `composerData:<composerId>` -> { fullConversationHeadersOnly:
+ *         [{bubbleId, type}] } — the ordered conversation.
+ *       key `bubbleId:<composerId>:<bubbleId>` -> the message:
+ *         { type: 1(user)|2(assistant), text, createdAt (ISO),
+ *           toolFormerData?: { name, rawArgs, status } }.
+ *
+ * Uses node:sqlite (built-in, Node >= 22.5) — read-only, no native deps. The
+ * DB can be multi-GB, so bubbles are fetched by key, never table-scanned.
+ */
+import type { NsfSession } from "../nsf.js";
+export declare const CURSOR_TOOL_ID = "cursor";
+export declare function cursorDbPath(): string;
+/** Newest non-subagent Cursor conversation for a working directory, if any. */
+export declare function findCursorComposer(cwd: string): {
+    composerId: string;
+    mtimeMs: number;
+} | undefined;
+/**
+ * Parse one Cursor conversation into NSF.
+ * @param dbPath absolute path to Cursor's global state.vscdb
+ * @param composerId the conversation to parse (from findCursorComposer)
+ */
+export declare function parseCursor(dbPath: string, composerId: string): NsfSession;

package/dist/parsers/cursor.js

@@ -0,0 +1,224 @@
+/**
+ * Cursor parser: global state.vscdb (SQLite) -> NSF.
+ *
+ * Grounded in the REAL on-disk schema (verified 2026-07-15 against a live
+ * Cursor install), not a guess:
+ *   - DB: <appdata>/Cursor/User/globalStorage/state.vscdb
+ *   - Table `composerHeaders` (composerId, workspaceId, lastUpdatedAt,
+ *     isSubagent, recency, value JSON) — value carries `name` (the chat title),
+ *     `workspaceIdentifier.uri.fsPath` (cwd) and `trackedGitRepos[].branches`.
+ *   - Table `cursorDiskKV`:
+ *       key `composerData:<composerId>` -> { fullConversationHeadersOnly:
+ *         [{bubbleId, type}] } — the ordered conversation.
+ *       key `bubbleId:<composerId>:<bubbleId>` -> the message:
+ *         { type: 1(user)|2(assistant), text, createdAt (ISO),
+ *           toolFormerData?: { name, rawArgs, status } }.
+ *
+ * Uses node:sqlite (built-in, Node >= 22.5) — read-only, no native deps. The
+ * DB can be multi-GB, so bubbles are fetched by key, never table-scanned.
+ */
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { homedir, platform } from "node:os";
+import { join } from "node:path";
+import { NSF_VERSION } from "../nsf.js";
+export const CURSOR_TOOL_ID = "cursor";
+export function cursorDbPath() {
+    const base = platform() === "darwin"
+        ? join(homedir(), "Library", "Application Support")
+        : platform() === "win32"
+            ? (process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"))
+            : (process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"));
+    return join(base, "Cursor", "User", "globalStorage", "state.vscdb");
+}
+// node:sqlite is the whole reason this parser has zero dependencies, but it
+// needs Node >= 22.5. Loaded lazily so the rest of sup works on older Nodes.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function openDb(path) {
+    let sqlite;
+    try {
+        sqlite = createRequire(import.meta.url)("node:sqlite");
+    }
+    catch {
+        throw new Error("Reading Cursor sessions needs Node 22.5+ (built-in node:sqlite).");
+    }
+    return new sqlite.DatabaseSync(path, { readOnly: true });
+}
+function parseHeaderRow(row) {
+    try {
+        const v = JSON.parse(row.value);
+        if (v.isDraft)
+            return undefined;
+        const branches = v.trackedGitRepos?.[0]?.branches ?? [];
+        const branch = branches.reduce((best, b) => ((b.lastInteractionAt ?? 0) > (best?.lastInteractionAt ?? -1) ? b : best), undefined)?.branchName;
+        return {
+            composerId: row.composerId,
+            lastUpdatedAt: row.lastUpdatedAt,
+            name: v.name,
+            fsPath: v.workspaceIdentifier?.uri?.fsPath ?? v.trackedGitRepos?.[0]?.repoPath,
+            branch,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Newest non-subagent Cursor conversation for a working directory, if any. */
+export function findCursorComposer(cwd) {
+    const dbPath = cursorDbPath();
+    if (!existsSync(dbPath))
+        return undefined;
+    let db;
+    try {
+        db = openDb(dbPath);
+    }
+    catch {
+        return undefined; // old Node or locked DB — discovery degrades gracefully
+    }
+    try {
+        const rows = db
+            .prepare(`SELECT composerId, lastUpdatedAt, value FROM composerHeaders
+         WHERE isSubagent = 0 ORDER BY recency DESC LIMIT 200`)
+            .all();
+        for (const row of rows) {
+            const h = parseHeaderRow(row);
+            if (h?.fsPath === cwd)
+                return { composerId: h.composerId, mtimeMs: h.lastUpdatedAt };
+        }
+        return undefined;
+    }
+    finally {
+        db.close();
+    }
+}
+/** Map a Cursor tool name (e.g. "read_file_v2", "ripgrep_raw_search") to NSF. */
+function normalizeCursorTool(name) {
+    if (/terminal|shell|command|exec/.test(name))
+        return "run";
+    if (/edit|apply|write|create|replace/.test(name))
+        return "edit";
+    if (/read|view|open/.test(name))
+        return "read";
+    if (/search|grep|glob|codebase|list_dir|ripgrep/.test(name))
+        return "search";
+    return "other";
+}
+function actionFrom(tfd) {
+    const rawName = typeof tfd.name === "string" ? tfd.name : "unknown";
+    let path;
+    let command;
+    const rawArgs = tfd.rawArgs ?? tfd.params;
+    if (typeof rawArgs === "string") {
+        try {
+            const a = JSON.parse(rawArgs);
+            const p = a.path ?? a.targetFile ?? a.target_file ?? a.file_path;
+            path = typeof p === "string" ? p : undefined;
+            command = typeof a.command === "string" ? a.command : undefined;
+        }
+        catch {
+            // unparseable args — the tool name alone is still signal
+        }
+    }
+    return {
+        kind: normalizeCursorTool(rawName),
+        rawName,
+        path,
+        command,
+        failed: tfd.status === "error" ? true : undefined,
+    };
+}
+/**
+ * Parse one Cursor conversation into NSF.
+ * @param dbPath absolute path to Cursor's global state.vscdb
+ * @param composerId the conversation to parse (from findCursorComposer)
+ */
+export function parseCursor(dbPath, composerId) {
+    const db = openDb(dbPath);
+    try {
+        const kv = db.prepare(`SELECT value FROM cursorDiskKV WHERE key = ?`);
+        const header = db
+            .prepare(`SELECT composerId, lastUpdatedAt, value FROM composerHeaders WHERE composerId = ?`)
+            .get(composerId);
+        const head = header ? parseHeaderRow(header) : undefined;
+        const dataRow = kv.get(`composerData:${composerId}`);
+        if (!dataRow)
+            throw new Error(`Cursor conversation ${composerId} not found in ${dbPath}`);
+        const data = JSON.parse(dataRow.value);
+        const order = data.fullConversationHeadersOnly ?? [];
+        const turns = [];
+        const filesSeen = new Set();
+        const filesOrdered = [];
+        const gapCounts = new Map();
+        const addGap = (reason) => gapCounts.set(reason, (gapCounts.get(reason) ?? 0) + 1);
+        let rawBytes = 0;
+        for (const { bubbleId } of order) {
+            const row = kv.get(`bubbleId:${composerId}:${bubbleId}`);
+            if (!row) {
+                addGap("missing bubble record");
+                continue;
+            }
+            rawBytes += row.value.length;
+            let bubble;
+            try {
+                bubble = JSON.parse(row.value);
+            }
+            catch {
+                addGap("unparseable bubble");
+                continue;
+            }
+            const role = bubble.type === 1 ? "user" : bubble.type === 2 ? "assistant" : undefined;
+            if (!role) {
+                addGap("bubble with unknown type");
+                continue;
+            }
+            const text = (bubble.text ?? "").trim();
+            const actions = [];
+            if (bubble.toolFormerData && typeof bubble.toolFormerData === "object") {
+                const a = actionFrom(bubble.toolFormerData);
+                actions.push(a);
+                if (a.path && !filesSeen.has(a.path)) {
+                    filesSeen.add(a.path);
+                    filesOrdered.push(a.path);
+                }
+            }
+            if (!text && actions.length === 0) {
+                addGap("empty turn");
+                continue;
+            }
+            // Cursor stores each tool call as its own assistant bubble; fold
+            // consecutive action-only bubbles into the previous assistant turn so
+            // NSF reads as conversation, not a tool ledger.
+            const prev = turns[turns.length - 1];
+            if (role === "assistant" && !text && prev?.role === "assistant") {
+                prev.actions.push(...actions);
+                continue;
+            }
+            turns.push({
+                role,
+                text,
+                actions,
+                timestamp: bubble.createdAt ? Date.parse(bubble.createdAt) : undefined,
+            });
+        }
+        const gaps = [...gapCounts.entries()].map(([reason, count]) => ({ reason, count }));
+        return {
+            nsfVersion: NSF_VERSION,
+            provenance: {
+                tool: CURSOR_TOOL_ID,
+                sessionId: composerId,
+                title: head?.name,
+                cwd: head?.fsPath,
+                gitBranch: head?.branch,
+                rawBytes,
+                compactions: 0,
+            },
+            turns,
+            filesTouched: filesOrdered,
+            gaps,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/parsers/cursor.js.map

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