@tracebench/adapter-cursor 0.2.0

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Copyright 2026 Tracebench Contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,55 @@
+# @tracebench/adapter-cursor
+
+Tracebench adapter for **Cursor Agent** session transcripts (JSONL).
+
+## Phase 1 (shipped): agent-transcripts JSONL
+
+Cursor writes supplementary agent logs under:
+
+```
+~/.cursor/projects/<sanitized-project-path>/agent-transcripts/
+  <session-uuid>/<session-uuid>.jsonl     # nested layout
+  <session-uuid>.jsonl                   # flat layout
+  <parent-uuid>/subagents/<subagent-uuid>.jsonl
+```
+
+- **Default root:** `~/.cursor/projects` (override with `tracebench --cursor-dir <path>`)
+- **Format version:** `2026-q1`
+- **Harness id:** `cursor`
+
+### Limitations (JSONL only)
+
+Cursor's JSONL export does not include:
+
+- `tool_result` lines (tool outputs are not separate events)
+- per-line timestamps (synthetic timestamps from file mtime)
+- token usage / model id (cost analytics show zeros)
+
+The UI still renders `tool_call` events (Read, Write, Bash, Task, etc.) with **input only**.
+
+## Phase 2 (planned): Composer SQLite (`state.vscdb`)
+
+Full Composer / Ask history lives in Cursor's VS Code–style SQLite DBs. Paths by OS:
+
+| OS | Global DB (`bubbleId`, `composerData`, …) |
+|----|-------------------------------------------|
+| macOS | `~/Library/Application Support/Cursor/User/globalStorage/state.vscdb` |
+| Linux | `~/.config/Cursor/User/globalStorage/state.vscdb` |
+| Windows | `%APPDATA%\Cursor\User\globalStorage\state.vscdb` |
+
+Per-workspace index (Cursor ≤2.6): `<User>/workspaceStorage/<id>/state.vscdb` + `workspace.json`.
+
+**Read WAL consistently:** copy `state.vscdb`, `state.vscdb-wal`, and `state.vscdb-shm` together.
+
+Phase 2 will:
+
+1. List composers via `composer.composerHeaders` (3.0+) or workspace `composer.composerData` (≤2.6).
+2. Load `cursorDiskKV` keys `composerData:{id}` and `bubbleId:{id}:{bubbleId}`.
+3. Normalize bubbles into `CanonicalEvent` (including tool results where present).
+4. Dedupe with JSONL sessions when `composerId` matches the transcript folder UUID.
+
+Helpers exported for Phase 2: `defaultCursorUserDataDir()`, `defaultCursorGlobalDbPath()` in `src/paths.ts`.
+
+## SSH / WSL
+
+Chat data stays on the machine running the Cursor UI (not the remote SSH host). Use the data dir for whichever Cursor install you actually run.

package/dist/discover.d.ts

@@ -0,0 +1,11 @@
+import { defaultCursorProjectsRoot } from './paths.js';
+export interface DiscoveredCursorSession {
+    session_id: string;
+    file_path: string;
+    encoded_project_dir: string;
+    size: number;
+    mtime_ms: number;
+}
+export { defaultCursorProjectsRoot as defaultProjectsRoot };
+export declare function discoverSessions(root?: string): DiscoveredCursorSession[];
+//# sourceMappingURL=discover.d.ts.map

package/dist/discover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,OAAO,EAAE,yBAAyB,IAAI,mBAAmB,EAAE,CAAC;AAsC5D,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,uBAAuB,EAAE,CAiBzE"}

package/dist/discover.js

@@ -0,0 +1,65 @@
+// Discover Cursor agent transcripts on disk.
+//
+// Layout:
+//   ~/.cursor/projects/<sanitized-path>/agent-transcripts/
+//     <session-uuid>.jsonl                         (flat)
+//     <session-uuid>/<session-uuid>.jsonl          (nested)
+//     <parent-uuid>/subagents/<subagent-uuid>.jsonl
+import { readdirSync, statSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { defaultCursorProjectsRoot } from './paths.js';
+export { defaultCursorProjectsRoot as defaultProjectsRoot };
+function walkJsonl(dir, encodedProjectDir, out) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const ent of entries) {
+        const name = String(ent.name);
+        const p = join(dir, name);
+        if (ent.isDirectory()) {
+            walkJsonl(p, encodedProjectDir, out);
+            continue;
+        }
+        if (!name.endsWith('.jsonl'))
+            continue;
+        let st;
+        try {
+            st = statSync(p);
+        }
+        catch {
+            continue;
+        }
+        const sessionId = basename(name, '.jsonl');
+        out.push({
+            session_id: sessionId,
+            file_path: p,
+            encoded_project_dir: encodedProjectDir,
+            size: st.size,
+            mtime_ms: st.mtimeMs,
+        });
+    }
+}
+export function discoverSessions(root) {
+    const base = root ?? defaultCursorProjectsRoot();
+    const out = [];
+    let projectDirs;
+    try {
+        projectDirs = readdirSync(base, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+    }
+    catch {
+        return out;
+    }
+    for (const dir of projectDirs) {
+        const transcriptsDir = join(base, dir, 'agent-transcripts');
+        walkJsonl(transcriptsDir, dir, out);
+    }
+    out.sort((a, b) => b.mtime_ms - a.mtime_ms);
+    return out;
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover.js","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,EAAE;AACF,UAAU;AACV,2DAA2D;AAC3D,0DAA0D;AAC1D,4DAA4D;AAC5D,oDAAoD;AAEpD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAUvD,OAAO,EAAE,yBAAyB,IAAI,mBAAmB,EAAE,CAAC;AAE5D,SAAS,SAAS,CAChB,GAAW,EACX,iBAAyB,EACzB,GAA8B;IAE9B,IAAI,OAAmC,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAA+B,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;YACtB,SAAS,CAAC,CAAC,EAAE,iBAAiB,EAAE,GAAG,CAAC,CAAC;YACrC,SAAS;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAAE,SAAS;QACvC,IAAI,EAAE,CAAC;QACP,IAAI,CAAC;YACH,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACnB,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC;YACP,UAAU,EAAE,SAAS;YACrB,SAAS,EAAE,CAAC;YACZ,mBAAmB,EAAE,iBAAiB;YACtC,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,QAAQ,EAAE,EAAE,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,MAAM,IAAI,GAAG,IAAI,IAAI,yBAAyB,EAAE,CAAC;IACjD,MAAM,GAAG,GAA8B,EAAE,CAAC;IAC1C,IAAI,WAAqB,CAAC;IAC1B,IAAI,CAAC;QACH,WAAW,GAAG,WAAW,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACrD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,CAAC;QAC9B,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,mBAAmB,CAAC,CAAC;QAC5D,SAAS,CAAC,cAAc,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export declare const HARNESS_NAME: "cursor";
+export declare const FORMAT_VERSION = "2026-q1";
+export { defaultCursorProjectsRoot, defaultCursorUserDataDir, defaultCursorGlobalDbPath, decodeProjectPath, } from './paths.js';
+export { defaultProjectsRoot, discoverSessions, type DiscoveredCursorSession } from './discover.js';
+export { parseSession, streamSession, type RawCursorEvent } from './parse.js';
+export { loadSession, normalizeSession, parseTranscriptPath, type NormalizeResult, } from './normalize.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,EAAG,QAAiB,CAAC;AAC9C,eAAO,MAAM,cAAc,YAAY,CAAC;AAExC,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9E,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export const HARNESS_NAME = 'cursor';
+export const FORMAT_VERSION = '2026-q1';
+export { defaultCursorProjectsRoot, defaultCursorUserDataDir, defaultCursorGlobalDbPath, decodeProjectPath, } from './paths.js';
+export { defaultProjectsRoot, discoverSessions } from './discover.js';
+export { parseSession, streamSession } from './parse.js';
+export { loadSession, normalizeSession, parseTranscriptPath, } from './normalize.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,QAAiB,CAAC;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC;AAExC,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAgC,MAAM,eAAe,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,aAAa,EAAuB,MAAM,YAAY,CAAC;AAC9E,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,mBAAmB,GAEpB,MAAM,gBAAgB,CAAC"}

package/dist/normalize.d.ts

@@ -0,0 +1,26 @@
+import type { CanonicalEvent, Session } from '@tracebench/core';
+import type { RawCursorEvent } from './parse.js';
+interface NormalizeOptions {
+    rawPath: string;
+    sessionId?: string;
+    formatVersion: string;
+    /** File mtime (ms) — used for synthetic per-line timestamps. */
+    fileMtimeMs?: number;
+    encodedProjectDir?: string;
+}
+export interface NormalizeResult {
+    session: Session;
+    events: CanonicalEvent[];
+}
+export declare function parseTranscriptPath(rawPath: string): {
+    encoded_project_dir: string | null;
+    subagent: boolean;
+    parent_session_id: string | null;
+};
+export declare function normalizeSession(raws: RawCursorEvent[], opts: NormalizeOptions): NormalizeResult;
+export declare function loadSession(filePath: string, opts?: {
+    formatVersion?: string;
+    encodedProjectDir?: string;
+}): Promise<NormalizeResult>;
+export {};
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAwB,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGjD,UAAU,gBAAgB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AA6CD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IACpD,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,EAAE,OAAO,CAAC;IAClB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC,CAYA;AAWD,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,cAAc,EAAE,EACtB,IAAI,EAAE,gBAAgB,GACrB,eAAe,CA4MjB;AAKD,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAO,GAChE,OAAO,CAAC,eAAe,CAAC,CAiB1B"}

package/dist/normalize.js

@@ -0,0 +1,284 @@
+// Convert Cursor agent-transcript JSONL into canonical Tracebench events.
+//
+// Cursor writes supplementary logs under ~/.cursor/projects/.../agent-transcripts/.
+// Format is Anthropic-like (role + message.content blocks) but:
+//   - no per-line timestamps (synthetic timestamps from file mtime)
+//   - tool_use blocks have no id field
+//   - no tool_result lines — tool outputs are not exported separately
+//
+// Turn boundaries: each user text message starts a new turn.
+import { decodeProjectPath } from './paths.js';
+function emptyTool() {
+    return { name: null, input: null, output: null, status: null, error_message: null };
+}
+const emptyTokens = {
+    input: null,
+    output: null,
+    cache_read: null,
+    cache_creation: null,
+    reasoning: null,
+};
+function toString(content) {
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        const parts = content
+            .map((b) => {
+            if (typeof b === 'string')
+                return b;
+            if (b && typeof b === 'object' && 'text' in b && typeof b.text === 'string') {
+                return b.text;
+            }
+            return '';
+        })
+            .filter((s) => s.length > 0);
+        return parts.length > 0 ? parts.join('\n') : null;
+    }
+    return null;
+}
+function stripUserQuery(text) {
+    if (text == null)
+        return null;
+    const stripped = text.replace(/<\/?user_query>/gi, '').trim();
+    return stripped.length > 0 ? stripped : null;
+}
+function deriveTitle(content) {
+    const s = stripUserQuery(toString(content));
+    if (!s)
+        return null;
+    const single = s.replace(/\s+/g, ' ').trim();
+    if (!single)
+        return null;
+    return single.length > 120 ? single.slice(0, 117) + '...' : single;
+}
+export function parseTranscriptPath(rawPath) {
+    const dirMatch = rawPath.match(/\/projects\/([^/]+)\/agent-transcripts\//);
+    const encoded = dirMatch ? dirMatch[1] : null;
+    const subMatch = /\/agent-transcripts\/([^/]+)\/subagents\/([^/]+)\.jsonl$/i.exec(rawPath);
+    if (subMatch) {
+        return {
+            encoded_project_dir: encoded,
+            subagent: true,
+            parent_session_id: subMatch[1],
+        };
+    }
+    return { encoded_project_dir: encoded, subagent: false, parent_session_id: null };
+}
+function syntheticTimestamps(lineCount, endMs) {
+    if (lineCount === 0)
+        return [];
+    const span = Math.max(lineCount - 1, 0) * 1000;
+    const startMs = endMs - span;
+    return Array.from({ length: lineCount }, (_, i) => new Date(startMs + i * 1000).toISOString());
+}
+export function normalizeSession(raws, opts) {
+    const pathInfo = parseTranscriptPath(opts.rawPath);
+    const encodedDir = opts.encodedProjectDir ?? pathInfo.encoded_project_dir ?? 'unknown';
+    const projectPath = decodeProjectPath(encodedDir);
+    let resolvedSessionId = opts.sessionId ?? null;
+    if (!resolvedSessionId) {
+        resolvedSessionId =
+            opts.rawPath.split('/').pop()?.replace(/\.jsonl$/, '') ?? 'unknown';
+    }
+    const endMs = opts.fileMtimeMs ?? Date.now();
+    const timestamps = syntheticTimestamps(raws.length, endMs);
+    const firstTs = timestamps[0] ?? new Date(endMs).toISOString();
+    const lastTs = timestamps[timestamps.length - 1] ?? firstTs;
+    let firstUser;
+    for (const r of raws) {
+        if (r.role === 'user' && !firstUser)
+            firstUser = r;
+    }
+    const titleSource = firstUser
+        ? (firstUser.message?.content ?? null)
+        : null;
+    const title = deriveTitle(titleSource);
+    const source = {
+        harness: 'cursor',
+        format_version: opts.formatVersion,
+        raw_path: opts.rawPath,
+    };
+    const sessionMeta = {
+        encoded_project_dir: encodedDir,
+    };
+    if (pathInfo.subagent) {
+        sessionMeta.subagent = true;
+        if (pathInfo.parent_session_id)
+            sessionMeta.parent_session_id = pathInfo.parent_session_id;
+    }
+    const events = [];
+    let turnIndex = 0;
+    let currentTurnId = `${resolvedSessionId}::t0`;
+    function newTurn() {
+        turnIndex += 1;
+        currentTurnId = `${resolvedSessionId}::t${turnIndex}`;
+        return currentTurnId;
+    }
+    function baseMeta(extra = {}) {
+        return { ...sessionMeta, ...extra };
+    }
+    for (let lineIndex = 0; lineIndex < raws.length; lineIndex++) {
+        const r = raws[lineIndex];
+        const ts = timestamps[lineIndex] ?? lastTs;
+        const role = typeof r.role === 'string' ? r.role : 'unknown';
+        if (role === 'user') {
+            newTurn();
+            const content = r.message?.content;
+            events.push({
+                event_id: `cursor:${resolvedSessionId}:u:${lineIndex}`,
+                session_id: resolvedSessionId,
+                turn_id: currentTurnId,
+                parent_event_id: null,
+                timestamp: ts,
+                source,
+                role: 'user',
+                event_type: 'message',
+                model: null,
+                tokens: { ...emptyTokens },
+                cost_usd: null,
+                cost_method: null,
+                duration_ms: null,
+                content: stripUserQuery(toString(content)),
+                tool: emptyTool(),
+                metadata: baseMeta(),
+                raw: r,
+            });
+            continue;
+        }
+        if (role === 'assistant') {
+            const msg = r.message ?? {};
+            const blocks = Array.isArray(msg.content) ? msg.content : [];
+            if (blocks.length === 0) {
+                events.push({
+                    event_id: `cursor:${resolvedSessionId}:a:${lineIndex}:0`,
+                    session_id: resolvedSessionId,
+                    turn_id: currentTurnId,
+                    parent_event_id: null,
+                    timestamp: ts,
+                    source,
+                    role: 'assistant',
+                    event_type: 'message',
+                    model: null,
+                    tokens: { ...emptyTokens },
+                    cost_usd: null,
+                    cost_method: null,
+                    duration_ms: null,
+                    content: null,
+                    tool: emptyTool(),
+                    metadata: baseMeta({ empty: true }),
+                    raw: r,
+                });
+                continue;
+            }
+            for (let bi = 0; bi < blocks.length; bi++) {
+                const block = blocks[bi];
+                const blockType = typeof block.type === 'string' ? block.type : '';
+                const eventId = `cursor:${resolvedSessionId}:${lineIndex}:${bi}`;
+                let evtType = 'message';
+                let toolInfo = emptyTool();
+                let contentField = null;
+                if (blockType === 'text') {
+                    evtType = 'message';
+                    contentField = typeof block.text === 'string' ? block.text : null;
+                }
+                else if (blockType === 'tool_use') {
+                    evtType = 'tool_call';
+                    toolInfo = {
+                        name: typeof block.name === 'string' ? block.name : null,
+                        input: block.input ?? null,
+                        output: null,
+                        status: null,
+                        error_message: null,
+                    };
+                }
+                else if (blockType === 'thinking') {
+                    evtType = 'thinking';
+                    contentField =
+                        typeof block.thinking === 'string'
+                            ? block.thinking
+                            : typeof block.text === 'string'
+                                ? block.text
+                                : null;
+                }
+                else {
+                    evtType = 'meta';
+                    contentField = block;
+                }
+                events.push({
+                    event_id: eventId,
+                    session_id: resolvedSessionId,
+                    turn_id: currentTurnId,
+                    parent_event_id: null,
+                    timestamp: ts,
+                    source,
+                    role: 'assistant',
+                    event_type: evtType,
+                    model: null,
+                    tokens: { ...emptyTokens },
+                    cost_usd: null,
+                    cost_method: null,
+                    duration_ms: null,
+                    content: contentField,
+                    tool: toolInfo,
+                    metadata: baseMeta(blockType && blockType !== 'text' ? { block_type: blockType } : {}),
+                    raw: bi === 0 ? r : { _ref_line: lineIndex },
+                });
+            }
+            continue;
+        }
+        events.push({
+            event_id: `cursor:${resolvedSessionId}:meta:${lineIndex}`,
+            session_id: resolvedSessionId,
+            turn_id: currentTurnId,
+            parent_event_id: null,
+            timestamp: ts,
+            source,
+            role: 'system',
+            event_type: 'meta',
+            model: null,
+            tokens: { ...emptyTokens },
+            cost_usd: null,
+            cost_method: null,
+            duration_ms: null,
+            content: null,
+            tool: emptyTool(),
+            metadata: baseMeta({ kind: role }),
+            raw: r,
+        });
+    }
+    const session = {
+        session_id: resolvedSessionId,
+        harness: 'cursor',
+        project_path: projectPath,
+        title,
+        started_at: firstTs,
+        ended_at: lastTs,
+        model: null,
+        raw_path: opts.rawPath,
+        format_version: opts.formatVersion,
+        mtime_ms: 0,
+    };
+    return { session, events };
+}
+import { parseSession } from './parse.js';
+import { promises as fs } from 'node:fs';
+export async function loadSession(filePath, opts = {}) {
+    const raws = await parseSession(filePath);
+    let fileMtimeMs;
+    try {
+        const st = await fs.stat(filePath);
+        fileMtimeMs = st.mtimeMs;
+    }
+    catch {
+        // ignore
+    }
+    const sessionId = filePath.split('/').pop()?.replace(/\.jsonl$/, '');
+    return normalizeSession(raws, {
+        rawPath: filePath,
+        sessionId,
+        formatVersion: opts.formatVersion ?? '2026-q1',
+        fileMtimeMs,
+        encodedProjectDir: opts.encodedProjectDir,
+    });
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,7 @@
+export type RawCursorEvent = Record<string, unknown> & {
+    role?: string;
+    message?: unknown;
+};
+export declare function streamSession(filePath: string): AsyncIterable<RawCursorEvent>;
+export declare function parseSession(filePath: string): Promise<RawCursorEvent[]>;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,wBAAuB,aAAa,CAClC,QAAQ,EAAE,MAAM,GACf,aAAa,CAAC,cAAc,CAAC,CAW/B;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAI9E"}

package/dist/parse.js

@@ -0,0 +1,24 @@
+// Stream a Cursor agent-transcript JSONL file line by line.
+import { createReadStream } from 'node:fs';
+import { createInterface } from 'node:readline';
+export async function* streamSession(filePath) {
+    const stream = createReadStream(filePath, { encoding: 'utf8' });
+    const rl = createInterface({ input: stream, crlfDelay: Infinity });
+    for await (const line of rl) {
+        if (!line.trim())
+            continue;
+        try {
+            yield JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+    }
+}
+export async function parseSession(filePath) {
+    const out = [];
+    for await (const ev of streamSession(filePath))
+        out.push(ev);
+    return out;
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAOhD,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,aAAa,CAClC,QAAgB;IAEhB,MAAM,MAAM,GAAG,gBAAgB,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAChE,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;IACnE,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC3B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAAgB;IACjD,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,aAAa,CAAC,QAAQ,CAAC;QAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7D,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,11 @@
+export declare function defaultCursorProjectsRoot(): string;
+/** VS Code–style Cursor `User/` data directory (global + workspace DBs). */
+export declare function defaultCursorUserDataDir(): string;
+/** Global Composer DB — Phase 2 reads this (not used by JSONL adapter yet). */
+export declare function defaultCursorGlobalDbPath(): string;
+/**
+ * Decode sanitized project dir name back to an absolute path (best-effort).
+ * Cursor encodes `/Users/me/proj` → `Users-me-proj` (leading slash stripped).
+ */
+export declare function decodeProjectPath(encoded: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAKA,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,IAAI,MAAM,CAYjD;AAED,+EAA+E;AAC/E,wBAAgB,yBAAyB,IAAI,MAAM,CAElD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYzD"}

package/dist/paths.js

@@ -0,0 +1,42 @@
+// Cursor on-disk path helpers (JSONL roots + future Composer SQLite locations).
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export function defaultCursorProjectsRoot() {
+    return join(homedir(), '.cursor', 'projects');
+}
+/** VS Code–style Cursor `User/` data directory (global + workspace DBs). */
+export function defaultCursorUserDataDir() {
+    const home = homedir();
+    switch (process.platform) {
+        case 'darwin':
+            return join(home, 'Library', 'Application Support', 'Cursor', 'User');
+        case 'win32': {
+            const appData = process.env.APPDATA ?? join(home, 'AppData', 'Roaming');
+            return join(appData, 'Cursor', 'User');
+        }
+        default:
+            return join(home, '.config', 'Cursor', 'User');
+    }
+}
+/** Global Composer DB — Phase 2 reads this (not used by JSONL adapter yet). */
+export function defaultCursorGlobalDbPath() {
+    return join(defaultCursorUserDataDir(), 'globalStorage', 'state.vscdb');
+}
+/**
+ * Decode sanitized project dir name back to an absolute path (best-effort).
+ * Cursor encodes `/Users/me/proj` → `Users-me-proj` (leading slash stripped).
+ */
+export function decodeProjectPath(encoded) {
+    if (encoded.startsWith('Users-')) {
+        return '/Users/' + encoded.slice('Users-'.length).replace(/-/g, '/');
+    }
+    if (encoded.startsWith('home-')) {
+        return '/' + encoded.replace(/-/g, '/');
+    }
+    if (/^[A-Za-z]-/.test(encoded)) {
+        const drive = encoded[0].toUpperCase();
+        return drive + ':\\' + encoded.slice(2).replace(/-/g, '\\');
+    }
+    return encoded;
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,wBAAwB;IACtC,MAAM,IAAI,GAAG,OAAO,EAAE,CAAC;IACvB,QAAQ,OAAO,CAAC,QAAQ,EAAE,CAAC;QACzB,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,qBAAqB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACxE,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACxE,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QACD;YACE,OAAO,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,CAAC,wBAAwB,EAAE,EAAE,eAAe,EAAE,aAAa,CAAC,CAAC;AAC1E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,OAAO,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvE,CAAC;IACD,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,OAAO,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC;QACxC,OAAO,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/fixtures/01-simple.jsonl

@@ -0,0 +1,3 @@
+{"role":"user","message":{"content":[{"type":"text","text":"<user_query>\nRead the README and summarize it\n</user_query>"}]}}
+{"role":"assistant","message":{"content":[{"type":"text","text":"I'll read the README first."},{"type":"tool_use","name":"Read","input":{"path":"/Users/me/code/fixture/README.md"}}]}}
+{"role":"assistant","message":{"content":[{"type":"text","text":"The README describes a local-first session viewer."}]}}

package/fixtures/02-subagent.jsonl

@@ -0,0 +1,2 @@
+{"role":"user","message":{"content":[{"type":"text","text":"<user_query>\nExplore the repo structure\n</user_query>"}]}}
+{"role":"assistant","message":{"content":[{"type":"text","text":"Launching a subagent."},{"type":"tool_use","name":"Task","input":{"description":"Explore repo","prompt":"List top-level dirs"}}]}}