@tracebench/adapter-cursor 0.2.2 → 0.2.5

package/README.md

@@ -27,7 +27,7 @@ Cursor's JSONL export does not include:
 
 The UI still renders `tool_call` events (Read, Write, Bash, Task, etc.) with **input only**.
 
-## Phase 2 (planned): Composer SQLite (`state.vscdb`)
+## Phase 2 (shipped): Composer SQLite (`state.vscdb`)
 
 Full Composer / Ask history lives in Cursor's VS Code–style SQLite DBs. Paths by OS:
 
@@ -41,14 +41,16 @@ Per-workspace index (Cursor ≤2.6): `<User>/workspaceStorage/<id>/state.vscdb`
 
 **Read WAL consistently:** copy `state.vscdb`, `state.vscdb-wal`, and `state.vscdb-shm` together.
 
-Phase 2 will:
+Phase 2:
 
-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.
+1. Snapshots `state.vscdb` (+ `-wal`/`-shm`) for consistent reads while Cursor is open.
+2. Lists composers with stored bubbles; loads `composerData:{id}` and ordered `bubbleId:{id}:{bubbleId}` rows.
+3. Normalizes bubbles into `CanonicalEvent` — `tool_call` + `tool_result` (via `toolFormerData`), thinking (`capabilityType` 30), real timestamps, model id.
+4. Dedupes with JSONL: when `composerId` matches an agent-transcript folder UUID, the DB entry replaces JSONL.
 
-Helpers exported for Phase 2: `defaultCursorUserDataDir()`, `defaultCursorGlobalDbPath()` in `src/paths.ts`.
+Discovery merges both sources automatically. DB sessions use virtual paths `cursor-db:{composerId}@{globalDbPath}`.
+
+CLI: `tracebench --cursor-user-data-dir <path>` overrides the OS-default Cursor `User/` directory (see `defaultCursorUserDataDir()` in `src/paths.ts`).
 
 ## SSH / WSL
 

package/dist/db-fixture.d.ts

@@ -0,0 +1,2 @@
+export declare function createMinimalCursorDb(dbPath: string): void;
+//# sourceMappingURL=db-fixture.d.ts.map

package/dist/db-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-fixture.d.ts","sourceRoot":"","sources":["../src/db-fixture.ts"],"names":[],"mappings":"AAGA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CA6F1D"}

package/dist/db-fixture.js

@@ -0,0 +1,75 @@
+/** Build a minimal Cursor state.vscdb for tests. */
+import { SqliteDatabase } from '@tracebench/core';
+export function createMinimalCursorDb(dbPath) {
+    const db = new SqliteDatabase(dbPath);
+    db.exec(`
+    CREATE TABLE ItemTable (key TEXT PRIMARY KEY, value TEXT);
+    CREATE TABLE cursorDiskKV (key TEXT PRIMARY KEY, value TEXT);
+  `);
+    const composerId = 'aaaa-bbbb-cccc-dddd-eeeeeeeeeeee';
+    const userBubbleId = '11111111-1111-1111-1111-111111111111';
+    const thinkBubbleId = '22222222-2222-2222-2222-222222222222';
+    const toolBubbleId = '33333333-3333-3333-3333-333333333333';
+    db.prepare('INSERT INTO ItemTable (key, value) VALUES (?, ?)').run('composer.composerHeaders', JSON.stringify({
+        allComposers: [
+            {
+                type: 'head',
+                composerId,
+                name: 'Fixture composer chat',
+                lastUpdatedAt: 1_770_000_000_000,
+                createdAt: 1_769_999_000_000,
+                workspaceIdentifier: {
+                    uri: { fsPath: '/Users/me/code/fixture' },
+                },
+            },
+        ],
+    }));
+    db.prepare('INSERT INTO cursorDiskKV (key, value) VALUES (?, ?)').run(`composerData:${composerId}`, JSON.stringify({
+        composerId,
+        name: 'Fixture composer chat',
+        createdAt: 1_769_999_000_000,
+        lastUpdatedAt: 1_770_000_000_000,
+        unifiedMode: 'agent',
+        modelConfig: { modelName: 'composer-2.5' },
+        fullConversationHeadersOnly: [
+            { bubbleId: userBubbleId, type: 1 },
+            { bubbleId: thinkBubbleId, type: 2 },
+            { bubbleId: toolBubbleId, type: 2 },
+        ],
+        workspaceIdentifier: {
+            uri: { fsPath: '/Users/me/code/fixture' },
+        },
+    }));
+    db.prepare('INSERT INTO cursorDiskKV (key, value) VALUES (?, ?)').run(`bubbleId:${composerId}:${userBubbleId}`, JSON.stringify({
+        bubbleId: userBubbleId,
+        type: 1,
+        text: '<user_query>\nSummarize the fixture DB session\n</user_query>',
+        createdAt: '2026-05-18T10:00:00.000Z',
+    }));
+    db.prepare('INSERT INTO cursorDiskKV (key, value) VALUES (?, ?)').run(`bubbleId:${composerId}:${thinkBubbleId}`, JSON.stringify({
+        bubbleId: thinkBubbleId,
+        type: 2,
+        capabilityType: 30,
+        thinking: { text: 'Planning fixture response.' },
+        thinkingDurationMs: 50,
+        createdAt: '2026-05-18T10:00:01.000Z',
+    }));
+    const toolCallId = 'tool_fixture_call_001';
+    db.prepare('INSERT INTO cursorDiskKV (key, value) VALUES (?, ?)').run(`bubbleId:${composerId}:${toolBubbleId}`, JSON.stringify({
+        bubbleId: toolBubbleId,
+        type: 2,
+        capabilityType: 15,
+        createdAt: '2026-05-18T10:00:02.000Z',
+        modelInfo: { modelName: 'composer-2.5' },
+        tokenCount: { inputTokens: 10, outputTokens: 20 },
+        toolFormerData: {
+            toolCallId,
+            name: 'read_file',
+            status: 'completed',
+            params: JSON.stringify({ path: '/Users/me/code/fixture/README.md' }),
+            result: JSON.stringify({ output: '# Fixture\n', rejected: false }),
+        },
+    }));
+    db.close();
+}
+//# sourceMappingURL=db-fixture.js.map

package/dist/db-fixture.js.map

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

package/dist/db-read.d.ts

@@ -0,0 +1,26 @@
+import type { ComposerDataRow, ConversationHeader, CursorBubble } from './db-types.js';
+export interface ComposerListEntry {
+    composerId: string;
+    name: string | null;
+    subtitle: string | null;
+    projectPath: string | null;
+    createdAtMs: number | null;
+    lastUpdatedAtMs: number | null;
+    unifiedMode: string | null;
+    modelName: string | null;
+    bubbleCount: number;
+    /** Number of bubbles listed in fullConversationHeadersOnly (may be 0 for agent sessions). */
+    headerBubbleCount: number;
+}
+/** List composers that have at least one stored bubble. */
+export declare function listComposersWithBubbles(dbPath: string): ComposerListEntry[];
+export interface LoadedComposer {
+    composerId: string;
+    data: ComposerDataRow | null;
+    headers: ConversationHeader[];
+    bubbles: CursorBubble[];
+}
+export declare function loadComposerFromDb(dbPath: string, composerId: string): LoadedComposer | null;
+/** DB mtime for incremental indexing (main file only). */
+export declare function cursorDbMtimeMs(dbPath: string): number;
+//# sourceMappingURL=db-read.d.ts.map

package/dist/db-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-read.d.ts","sourceRoot":"","sources":["../src/db-read.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EAEf,kBAAkB,EAClB,YAAY,EACb,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,6FAA6F;IAC7F,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAuBD,2DAA2D;AAC3D,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAuE5E;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,cAAc,GAAG,IAAI,CA0DvB;AAED,0DAA0D;AAC1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMtD"}

package/dist/db-read.js

@@ -0,0 +1,142 @@
+// Read Composer sessions from Cursor's global state.vscdb.
+import { statSync } from 'node:fs';
+import { SqliteDatabase } from '@tracebench/core';
+import { snapshotCursorDb, releaseDbSnapshot } from './db-snapshot.js';
+function parseJson(raw) {
+    if (raw == null)
+        return null;
+    const s = typeof raw === 'string' ? raw : raw.toString('utf8');
+    if (!s)
+        return null;
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return null;
+    }
+}
+function workspacePath(ws) {
+    return ws?.uri?.fsPath ?? ws?.uri?.path ?? null;
+}
+function openReadonly(dbPath) {
+    return new SqliteDatabase(dbPath, { readonly: true, fileMustExist: true });
+}
+/** List composers that have at least one stored bubble. */
+export function listComposersWithBubbles(dbPath) {
+    const snap = snapshotCursorDb(dbPath);
+    if (!snap)
+        return [];
+    try {
+        const db = openReadonly(snap.dbPath);
+        const headersRaw = db
+            .prepare('SELECT value FROM ItemTable WHERE key = ?')
+            .get('composer.composerHeaders');
+        const headers = parseJson(headersRaw?.value);
+        const headerById = new Map();
+        for (const h of headers?.allComposers ?? []) {
+            if (h.composerId)
+                headerById.set(h.composerId, h);
+        }
+        const bubbleCounts = new Map();
+        const rows = db
+            .prepare(`SELECT key FROM cursorDiskKV WHERE key LIKE 'bubbleId:%'`)
+            .all();
+        for (const { key } of rows) {
+            const parts = key.split(':');
+            if (parts.length < 3)
+                continue;
+            const composerId = parts[1];
+            bubbleCounts.set(composerId, (bubbleCounts.get(composerId) ?? 0) + 1);
+        }
+        const composerIds = [...bubbleCounts.keys()];
+        const out = [];
+        const dataStmt = db.prepare('SELECT value FROM cursorDiskKV WHERE key = ?');
+        for (const composerId of composerIds) {
+            const dataRow = dataStmt.get(`composerData:${composerId}`);
+            const data = parseJson(dataRow?.value);
+            const header = headerById.get(composerId);
+            const name = data?.name ?? header?.name ?? header?.subtitle ?? data?.subtitle ?? null;
+            const projectPath = workspacePath(data?.workspaceIdentifier) ??
+                workspacePath(header?.workspaceIdentifier);
+            out.push({
+                composerId,
+                name: name ?? null,
+                subtitle: data?.subtitle ?? header?.subtitle ?? null,
+                projectPath,
+                createdAtMs: data?.createdAt ?? header?.createdAt ?? null,
+                lastUpdatedAtMs: data?.lastUpdatedAt ?? header?.lastUpdatedAt ?? null,
+                unifiedMode: data?.unifiedMode ?? header?.unifiedMode ?? null,
+                modelName: data?.modelConfig?.modelName ?? null,
+                bubbleCount: bubbleCounts.get(composerId) ?? 0,
+                headerBubbleCount: data?.fullConversationHeadersOnly?.length ?? 0,
+            });
+        }
+        db.close();
+        out.sort((a, b) => (b.lastUpdatedAtMs ?? 0) - (a.lastUpdatedAtMs ?? 0));
+        return out;
+    }
+    finally {
+        releaseDbSnapshot(snap);
+    }
+}
+export function loadComposerFromDb(dbPath, composerId) {
+    const snap = snapshotCursorDb(dbPath);
+    if (!snap)
+        return null;
+    try {
+        const db = openReadonly(snap.dbPath);
+        const dataRow = db
+            .prepare('SELECT value FROM cursorDiskKV WHERE key = ?')
+            .get(`composerData:${composerId}`);
+        const data = parseJson(dataRow?.value);
+        const headerList = data?.fullConversationHeadersOnly ?? [];
+        const bubbles = [];
+        const bubbleStmt = db.prepare('SELECT value FROM cursorDiskKV WHERE key = ?');
+        const prefix = `bubbleId:${composerId}:`;
+        if (headerList.length > 0) {
+            for (const h of headerList) {
+                const row = bubbleStmt.get(`${prefix}${h.bubbleId}`);
+                const bubble = parseJson(row?.value);
+                if (bubble)
+                    bubbles.push(bubble);
+            }
+        }
+        else {
+            const all = db
+                .prepare(`SELECT key, value FROM cursorDiskKV WHERE key LIKE ?`)
+                .all(`${prefix}%`);
+            for (const row of all) {
+                const bubble = parseJson(row.value);
+                if (bubble)
+                    bubbles.push(bubble);
+            }
+            bubbles.sort((a, b) => {
+                const ta = a.createdAt ? Date.parse(a.createdAt) : 0;
+                const tb = b.createdAt ? Date.parse(b.createdAt) : 0;
+                return ta - tb;
+            });
+        }
+        db.close();
+        if (bubbles.length === 0 && !data)
+            return null;
+        return {
+            composerId,
+            data,
+            headers: headerList,
+            bubbles,
+        };
+    }
+    finally {
+        releaseDbSnapshot(snap);
+    }
+}
+/** DB mtime for incremental indexing (main file only). */
+export function cursorDbMtimeMs(dbPath) {
+    try {
+        return statSync(dbPath).mtimeMs;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=db-read.js.map

package/dist/db-read.js.map

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

package/dist/db-snapshot.d.ts

@@ -0,0 +1,13 @@
+export interface DbSnapshot {
+    /** Path to the copied main DB file (inside a temp dir). */
+    dbPath: string;
+    /** Temp directory holding the snapshot; call `releaseDbSnapshot` when done. */
+    tempDir: string;
+}
+/**
+ * Snapshot `state.vscdb` (and `-wal`/`-shm` when present) into a temp directory.
+ * Returns null when the main DB file does not exist.
+ */
+export declare function snapshotCursorDb(mainDbPath: string): DbSnapshot | null;
+export declare function releaseDbSnapshot(snapshot: DbSnapshot | null): void;
+//# sourceMappingURL=db-snapshot.d.ts.map

package/dist/db-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-snapshot.d.ts","sourceRoot":"","sources":["../src/db-snapshot.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CActE;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAOnE"}

package/dist/db-snapshot.js

@@ -0,0 +1,34 @@
+// Copy Cursor's state.vscdb (+ WAL sidecars) for consistent reads while Cursor is running.
+import { copyFileSync, existsSync, mkdtempSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { basename, join } from 'node:path';
+/**
+ * Snapshot `state.vscdb` (and `-wal`/`-shm` when present) into a temp directory.
+ * Returns null when the main DB file does not exist.
+ */
+export function snapshotCursorDb(mainDbPath) {
+    if (!existsSync(mainDbPath))
+        return null;
+    const tempDir = mkdtempSync(join(tmpdir(), 'tracebench-cursor-db-'));
+    const base = basename(mainDbPath);
+    const dir = join(mainDbPath, '..');
+    copyFileSync(mainDbPath, join(tempDir, base));
+    const wal = join(dir, `${base}-wal`);
+    const shm = join(dir, `${base}-shm`);
+    if (existsSync(wal))
+        copyFileSync(wal, join(tempDir, `${base}-wal`));
+    if (existsSync(shm))
+        copyFileSync(shm, join(tempDir, `${base}-shm`));
+    return { dbPath: join(tempDir, base), tempDir };
+}
+export function releaseDbSnapshot(snapshot) {
+    if (!snapshot)
+        return;
+    try {
+        rmSync(snapshot.tempDir, { recursive: true, force: true });
+    }
+    catch {
+        // ignore cleanup failures
+    }
+}
+//# sourceMappingURL=db-snapshot.js.map

package/dist/db-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-snapshot.js","sourceRoot":"","sources":["../src/db-snapshot.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAE3F,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAS3C;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAEzC,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,uBAAuB,CAAC,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAClC,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAEnC,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC;IACrC,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC;IACrE,IAAI,UAAU,CAAC,GAAG,CAAC;QAAE,YAAY,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC;IAErE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAA2B;IAC3D,IAAI,CAAC,QAAQ;QAAE,OAAO;IACtB,IAAI,CAAC;QACH,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,0BAA0B;IAC5B,CAAC;AACH,CAAC"}

package/dist/db-types.d.ts

@@ -0,0 +1,70 @@
+export interface ComposerHeaderEntry {
+    type?: string;
+    composerId: string;
+    name?: string;
+    subtitle?: string;
+    lastUpdatedAt?: number;
+    createdAt?: number;
+    unifiedMode?: string;
+    isArchived?: boolean;
+    workspaceIdentifier?: {
+        uri?: {
+            fsPath?: string;
+            path?: string;
+        };
+    };
+}
+export interface ConversationHeader {
+    bubbleId: string;
+    type: number;
+}
+export interface ComposerDataRow {
+    composerId: string;
+    name?: string;
+    subtitle?: string;
+    createdAt?: number;
+    lastUpdatedAt?: number;
+    unifiedMode?: string;
+    status?: string;
+    fullConversationHeadersOnly?: ConversationHeader[];
+    workspaceIdentifier?: {
+        uri?: {
+            fsPath?: string;
+            path?: string;
+        };
+    };
+    modelConfig?: {
+        modelName?: string;
+    };
+    isArchived?: boolean;
+    isDraft?: boolean;
+}
+export interface CursorBubble {
+    bubbleId?: string;
+    type?: number;
+    text?: string;
+    richText?: string;
+    createdAt?: string;
+    capabilityType?: number;
+    thinking?: {
+        text?: string;
+    };
+    thinkingDurationMs?: number;
+    modelInfo?: {
+        modelName?: string;
+    };
+    tokenCount?: {
+        inputTokens?: number;
+        outputTokens?: number;
+    };
+    toolFormerData?: {
+        toolCallId?: string;
+        name?: string;
+        status?: string;
+        rawArgs?: string;
+        params?: string;
+        result?: string;
+        additionalData?: Record<string, unknown>;
+    };
+}
+//# sourceMappingURL=db-types.d.ts.map

package/dist/db-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-types.d.ts","sourceRoot":"","sources":["../src/db-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE;QACpB,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1C,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACnD,mBAAmB,CAAC,EAAE;QACpB,GAAG,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1C,CAAC;IACF,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACnC,UAAU,CAAC,EAAE;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,cAAc,CAAC,EAAE;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC1C,CAAC;CACH"}

package/dist/db-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=db-types.js.map

package/dist/db-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-types.js","sourceRoot":"","sources":["../src/db-types.ts"],"names":[],"mappings":""}

package/dist/db-uri.d.ts

@@ -0,0 +1,8 @@
+/** Stable raw_path for a Composer session loaded from SQLite. */
+export declare function composerDbUri(composerId: string, globalDbPath: string): string;
+export declare function parseComposerDbUri(rawPath: string): {
+    composerId: string;
+    globalDbPath: string;
+} | null;
+export declare function isComposerDbUri(rawPath: string): boolean;
+//# sourceMappingURL=db-uri.d.ts.map

package/dist/db-uri.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-uri.d.ts","sourceRoot":"","sources":["../src/db-uri.ts"],"names":[],"mappings":"AAIA,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,GACd;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASrD;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAExD"}

package/dist/db-uri.js

@@ -0,0 +1,22 @@
+// Virtual paths for Composer DB sessions (indexed by tracebench as raw_path).
+const PREFIX = 'cursor-db:';
+/** Stable raw_path for a Composer session loaded from SQLite. */
+export function composerDbUri(composerId, globalDbPath) {
+    return `${PREFIX}${composerId}@${globalDbPath}`;
+}
+export function parseComposerDbUri(rawPath) {
+    if (!rawPath.startsWith(PREFIX))
+        return null;
+    const rest = rawPath.slice(PREFIX.length);
+    const at = rest.lastIndexOf('@');
+    if (at <= 0)
+        return null;
+    return {
+        composerId: rest.slice(0, at),
+        globalDbPath: rest.slice(at + 1),
+    };
+}
+export function isComposerDbUri(rawPath) {
+    return rawPath.startsWith(PREFIX);
+}
+//# sourceMappingURL=db-uri.js.map

package/dist/db-uri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-uri.js","sourceRoot":"","sources":["../src/db-uri.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,MAAM,MAAM,GAAG,YAAY,CAAC;AAE5B,iEAAiE;AACjE,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,YAAoB;IACpE,OAAO,GAAG,MAAM,GAAG,UAAU,IAAI,YAAY,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,OAAe;IAEf,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAC7B,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/discover-db.d.ts

@@ -0,0 +1,11 @@
+export interface DiscoveredComposerSession {
+    session_id: string;
+    file_path: string;
+    global_db_path: string;
+    project_path: string | null;
+    name: string | null;
+    size: number;
+    mtime_ms: number;
+}
+export declare function discoverComposerSessions(globalDbPath?: string): DiscoveredComposerSession[];
+//# sourceMappingURL=discover-db.d.ts.map

package/dist/discover-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-db.d.ts","sourceRoot":"","sources":["../src/discover-db.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,wBAAwB,CACtC,YAAY,CAAC,EAAE,MAAM,GACpB,yBAAyB,EAAE,CAc7B"}

package/dist/discover-db.js

@@ -0,0 +1,19 @@
+// Discover Cursor Composer sessions from global state.vscdb.
+import { defaultCursorGlobalDbPath } from './paths.js';
+import { listComposersWithBubbles, cursorDbMtimeMs } from './db-read.js';
+import { composerDbUri } from './db-uri.js';
+export function discoverComposerSessions(globalDbPath) {
+    const dbPath = globalDbPath ?? defaultCursorGlobalDbPath();
+    const dbMtime = cursorDbMtimeMs(dbPath);
+    const composers = listComposersWithBubbles(dbPath);
+    return composers.map((c) => ({
+        session_id: c.composerId,
+        file_path: composerDbUri(c.composerId, dbPath),
+        global_db_path: dbPath,
+        project_path: c.projectPath,
+        name: c.name,
+        size: c.bubbleCount,
+        mtime_ms: c.lastUpdatedAtMs ?? dbMtime,
+    }));
+}
+//# sourceMappingURL=discover-db.js.map

package/dist/discover-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discover-db.js","sourceRoot":"","sources":["../src/discover-db.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAY5C,MAAM,UAAU,wBAAwB,CACtC,YAAqB;IAErB,MAAM,MAAM,GAAG,YAAY,IAAI,yBAAyB,EAAE,CAAC;IAC3D,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,wBAAwB,CAAC,MAAM,CAAC,CAAC;IAEnD,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3B,UAAU,EAAE,CAAC,CAAC,UAAU;QACxB,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC;QAC9C,cAAc,EAAE,MAAM;QACtB,YAAY,EAAE,CAAC,CAAC,WAAW;QAC3B,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,IAAI,EAAE,CAAC,CAAC,WAAW;QACnB,QAAQ,EAAE,CAAC,CAAC,eAAe,IAAI,OAAO;KACvC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/discover.d.ts

@@ -5,7 +5,19 @@ export interface DiscoveredCursorSession {
     encoded_project_dir: string;
     size: number;
     mtime_ms: number;
+    /** Present when loaded from Composer SQLite instead of JSONL. */
+    source?: 'jsonl' | 'composer_db';
 }
 export { defaultCursorProjectsRoot as defaultProjectsRoot };
-export declare function discoverSessions(root?: string): DiscoveredCursorSession[];
+export interface DiscoverSessionsOptions {
+    /** Override ~/.cursor/projects */
+    projectsRoot?: string;
+    /** Override global state.vscdb path; set to false to skip DB discovery. */
+    globalDbPath?: string | false;
+}
+/**
+ * Discover agent-transcript JSONL sessions and Composer DB sessions.
+ * When the same composerId exists in both, the DB entry wins (richer events).
+ */
+export declare function discoverSessions(rootOrOpts?: string | DiscoverSessionsOptions): DiscoveredCursorSession[];
 //# sourceMappingURL=discover.d.ts.map

package/dist/discover.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"discover.d.ts","sourceRoot":"","sources":["../src/discover.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAGvD,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;IACjB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;CAClC;AAED,OAAO,EAAE,yBAAyB,IAAI,mBAAmB,EAAE,CAAC;AAsC5D,MAAM,WAAW,uBAAuB;IACtC,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAC/B;AAoBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,uBAAuB,GAC5C,uBAAuB,EAAE,CAmC3B"}

package/dist/discover.js

@@ -8,6 +8,7 @@
 import { readdirSync, statSync } from 'node:fs';
 import { join, basename } from 'node:path';
 import { defaultCursorProjectsRoot } from './paths.js';
+import { discoverComposerSessions } from './discover-db.js';
 export { defaultCursorProjectsRoot as defaultProjectsRoot };
 function walkJsonl(dir, encodedProjectDir, out) {
     let entries;
@@ -43,8 +44,7 @@ function walkJsonl(dir, encodedProjectDir, out) {
         });
     }
 }
-export function discoverSessions(root) {
-    const base = root ?? defaultCursorProjectsRoot();
+function discoverJsonlSessions(base) {
     const out = [];
     let projectDirs;
     try {
@@ -59,7 +59,42 @@ export function discoverSessions(root) {
         const transcriptsDir = join(base, dir, 'agent-transcripts');
         walkJsonl(transcriptsDir, dir, out);
     }
-    out.sort((a, b) => b.mtime_ms - a.mtime_ms);
+    for (const s of out)
+        s.source = 'jsonl';
     return out;
 }
+/**
+ * Discover agent-transcript JSONL sessions and Composer DB sessions.
+ * When the same composerId exists in both, the DB entry wins (richer events).
+ */
+export function discoverSessions(rootOrOpts) {
+    const opts = typeof rootOrOpts === 'string' ? { projectsRoot: rootOrOpts } : (rootOrOpts ?? {});
+    const base = opts.projectsRoot ?? defaultCursorProjectsRoot();
+    const jsonl = discoverJsonlSessions(base);
+    if (opts.globalDbPath === false) {
+        jsonl.sort((a, b) => b.mtime_ms - a.mtime_ms);
+        return jsonl;
+    }
+    let dbSessions = [];
+    try {
+        dbSessions = discoverComposerSessions(opts.globalDbPath === undefined ? undefined : opts.globalDbPath).map((d) => ({
+            session_id: d.session_id,
+            file_path: d.file_path,
+            encoded_project_dir: '',
+            size: d.size,
+            mtime_ms: d.mtime_ms,
+            source: 'composer_db',
+        }));
+    }
+    catch {
+        dbSessions = [];
+    }
+    const dbIds = new Set(dbSessions.map((s) => s.session_id));
+    const merged = [
+        ...dbSessions,
+        ...jsonl.filter((s) => !dbIds.has(s.session_id)),
+    ];
+    merged.sort((a, b) => b.mtime_ms - a.mtime_ms);
+    return merged;
+}
 //# sourceMappingURL=discover.js.map

package/dist/discover.js.map

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