sandstream-kit 1.1.0 → 1.3.0

package/dist/memory/cline.js

@@ -0,0 +1,117 @@
+/**
+ * kit memory — Cline transcript parser (multi-harness).
+ *
+ * Cline (VS Code extension `saoudrizwan.claude-dev`) stores each task under
+ * globalStorage/saoudrizwan.claude-dev/tasks/<taskId>/, with the conversation in
+ * api_conversation_history.json — an array of Anthropic-format messages:
+ *
+ *   [{ role: "user"|"assistant", content: string | [{ type:"text", text }, …] }]
+ *
+ * (verified against cline/cline + community readers). This is the same message
+ * shape kit already parses for Claude Code, so extraction is clean. We index
+ * user/assistant text turns, tag harness="cline", synthesize stable uuids.
+ * Idempotent, incremental, fail-safe, no model calls.
+ *
+ * Default path targets stable VS Code; point KIT_CLINE_DIR at the
+ * saoudrizwan.claude-dev dir for Cursor/Insiders/VSCodium installs.
+ */
+import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { insertMessage, upsertSession, isFileIndexed, markFileIndexed } from "./db.js";
+function vscodeGlobalStorage() {
+    const home = homedir();
+    switch (process.platform) {
+        case "darwin":
+            return join(home, "Library", "Application Support", "Code", "User", "globalStorage");
+        case "win32":
+            return join(process.env.APPDATA ?? join(home, "AppData", "Roaming"), "Code", "User", "globalStorage");
+        default:
+            return join(home, ".config", "Code", "User", "globalStorage");
+    }
+}
+export function getClineTasksDir() {
+    const base = process.env.KIT_CLINE_DIR ?? join(vscodeGlobalStorage(), "saoudrizwan.claude-dev");
+    return join(base, "tasks");
+}
+/** Flatten Anthropic content (string | block[]) to plain text. */
+function textOf(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((b) => (b?.type === "text" ? (b.text ?? "") : ""))
+            .filter(Boolean)
+            .join("\n");
+    }
+    return "";
+}
+function indexTask(db, taskId, filepath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(filepath, "utf8"));
+    }
+    catch {
+        return { messages: 0 };
+    }
+    if (!Array.isArray(parsed))
+        return { messages: 0 };
+    const sessionId = `cline:${taskId}`;
+    upsertSession(db, { sessionId, harness: "cline" });
+    let messages = 0;
+    parsed.forEach((msg, idx) => {
+        if (msg?.role !== "user" && msg?.role !== "assistant")
+            return;
+        const text = textOf(msg.content).trim();
+        if (!text)
+            return; // tool-only / image-only turns carry no searchable text
+        const added = insertMessage(db, {
+            uuid: `cline:${taskId}:${idx}`,
+            sessionId,
+            type: msg.role,
+            role: msg.role,
+            content: text,
+        });
+        if (added)
+            messages++;
+    });
+    return { messages };
+}
+/** Walk Cline's tasks dir and index every api_conversation_history.json. Idempotent + incremental. */
+export function indexClineSessions(db) {
+    const result = { files: 0, sessions: 0, messages: 0, toolUses: 0, filesSkipped: 0 };
+    const tasksDir = getClineTasksDir();
+    if (!existsSync(tasksDir))
+        return result;
+    let taskDirs;
+    try {
+        taskDirs = readdirSync(tasksDir, { withFileTypes: true });
+    }
+    catch {
+        return result;
+    }
+    for (const entry of taskDirs) {
+        if (!entry.isDirectory())
+            continue;
+        const filepath = join(tasksDir, entry.name, "api_conversation_history.json");
+        let st;
+        try {
+            st = statSync(filepath);
+        }
+        catch {
+            continue; // task without a conversation file → skip
+        }
+        const mtimeMs = Math.floor(st.mtimeMs);
+        if (isFileIndexed(db, filepath, mtimeMs, st.size)) {
+            result.filesSkipped++;
+            continue;
+        }
+        const counts = indexTask(db, entry.name, filepath);
+        markFileIndexed(db, filepath, mtimeMs, st.size);
+        result.files++;
+        result.sessions++;
+        result.messages += counts.messages;
+    }
+    return result;
+}
+//# sourceMappingURL=cline.js.map

package/dist/memory/cline.js.map

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

package/dist/memory/codex.d.ts

@@ -0,0 +1,5 @@
+import type { DatabaseSync } from "node:sqlite";
+import type { IndexResult } from "./parser.js";
+export declare function getCodexSessionsDir(): string;
+/** Walk ~/.codex/sessions and index every rollout. Idempotent + incremental (file_index). */
+export declare function indexCodexSessions(db: DatabaseSync): IndexResult;

package/dist/memory/codex.js

@@ -0,0 +1,150 @@
+/**
+ * kit memory — Codex CLI transcript parser (multi-harness).
+ *
+ * Reads OpenAI Codex rollout logs from ~/.codex/sessions/<yyyy>/<mm>/<dd>/rollout-*.jsonl.
+ * Each line is { timestamp, type, payload }: a `session_meta` line carries the
+ * session id + cwd; `response_item` lines of payload.type "message" carry the actual
+ * turns (role + content blocks). We index user/assistant turns (developer/system
+ * context is noise), tag them harness="codex", and synthesize a stable per-message
+ * uuid so re-indexing is idempotent. RAW + deterministic; no model calls.
+ */
+import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, basename } from "node:path";
+import { insertMessage, upsertSession, isFileIndexed, markFileIndexed } from "./db.js";
+export function getCodexSessionsDir() {
+    const base = process.env.KIT_CODEX_DIR ?? join(homedir(), ".codex");
+    return join(base, "sessions");
+}
+/** Flatten Codex content blocks (input_text / output_text / text) to plain text. */
+function textOf(content) {
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .map((b) => b?.type === "input_text" || b?.type === "output_text" || b?.type === "text"
+        ? (b.text ?? "")
+        : "")
+        .filter(Boolean)
+        .join("\n");
+}
+function* walkRollouts(dir) {
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const p = join(dir, entry.name);
+        if (entry.isDirectory())
+            yield* walkRollouts(p);
+        else if (entry.isFile() && entry.name.startsWith("rollout-") && entry.name.endsWith(".jsonl")) {
+            yield p;
+        }
+    }
+}
+function indexFile(db, filepath) {
+    let raw;
+    try {
+        raw = readFileSync(filepath, "utf8");
+    }
+    catch {
+        return { messages: 0 };
+    }
+    let sessionId = basename(filepath, ".jsonl");
+    let cwd;
+    let project;
+    let messages = 0;
+    let idx = 0;
+    let firstTs;
+    let lastTs;
+    for (const line of raw.split("\n")) {
+        const t = line.trim();
+        if (!t)
+            continue;
+        let rec;
+        try {
+            rec = JSON.parse(t);
+        }
+        catch {
+            continue;
+        }
+        if (rec.type === "session_meta") {
+            const p = rec.payload ?? {};
+            if (typeof p.id === "string")
+                sessionId = p.id;
+            if (typeof p.cwd === "string") {
+                cwd = p.cwd;
+                project = basename(p.cwd);
+            }
+            upsertSession(db, { sessionId, harness: "codex", project });
+            continue;
+        }
+        if (rec.type === "response_item" && rec.payload?.type === "message") {
+            const role = String(rec.payload.role ?? "");
+            if (role !== "user" && role !== "assistant")
+                continue; // skip developer/system noise
+            const ts = rec.timestamp;
+            if (ts) {
+                if (!firstTs)
+                    firstTs = ts;
+                lastTs = ts;
+            }
+            const added = insertMessage(db, {
+                uuid: `codex:${sessionId}:${idx}`, // stable per-session index → idempotent
+                sessionId,
+                type: role === "assistant" ? "assistant" : "user",
+                role,
+                content: textOf(rec.payload.content),
+                timestamp: ts,
+                cwd,
+            });
+            idx++;
+            if (added)
+                messages++;
+        }
+    }
+    upsertSession(db, {
+        sessionId,
+        harness: "codex",
+        project,
+        firstMessageAt: firstTs,
+        lastMessageAt: lastTs,
+    });
+    return { messages };
+}
+/** Walk ~/.codex/sessions and index every rollout. Idempotent + incremental (file_index). */
+export function indexCodexSessions(db) {
+    const dir = getCodexSessionsDir();
+    const result = {
+        files: 0,
+        sessions: 0,
+        messages: 0,
+        toolUses: 0,
+        filesSkipped: 0,
+    };
+    if (!existsSync(dir))
+        return result;
+    for (const filepath of walkRollouts(dir)) {
+        let st;
+        try {
+            st = statSync(filepath);
+        }
+        catch {
+            continue;
+        }
+        const mtimeMs = Math.floor(st.mtimeMs);
+        if (isFileIndexed(db, filepath, mtimeMs, st.size)) {
+            result.filesSkipped++;
+            continue;
+        }
+        const counts = indexFile(db, filepath);
+        markFileIndexed(db, filepath, mtimeMs, st.size);
+        result.files++;
+        result.sessions++;
+        result.messages += counts.messages;
+    }
+    return result;
+}
+//# sourceMappingURL=codex.js.map

package/dist/memory/codex.js.map

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

package/dist/memory/continue.d.ts

@@ -0,0 +1,5 @@
+import type { DatabaseSync } from "node:sqlite";
+import type { IndexResult } from "./parser.js";
+export declare function getContinueSessionsDir(): string;
+/** Walk ~/.continue/sessions and index every session JSON. Idempotent + incremental. */
+export declare function indexContinueSessions(db: DatabaseSync): IndexResult;

package/dist/memory/continue.js

@@ -0,0 +1,116 @@
+/**
+ * kit memory — Continue.dev transcript parser (multi-harness).
+ *
+ * Continue stores each chat as a Session JSON at ~/.continue/sessions/<id>.json
+ * (an index lives at sessions.json, which we skip). Types verified against the
+ * continuedev/continue source (core/index.d.ts):
+ *
+ *   Session          { sessionId, title, workspaceDirectory, history: ChatHistoryItem[] }
+ *   ChatHistoryItem  { message: ChatMessage, ... }
+ *   ChatMessage      { role: 'user'|'assistant'|'system'|'thinking'|'tool', content }
+ *   MessageContent   string | ({ type:'text', text } | { type:'imageUrl', ... })[]
+ *
+ * We index user + assistant turns, tag harness="continue", and — because Session
+ * carries workspaceDirectory — set cwd so Continue recall is project-scoped like
+ * Claude Code (not global-only). RAW + deterministic; idempotent; no model calls.
+ */
+import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join, basename } from "node:path";
+import { insertMessage, upsertSession, isFileIndexed, markFileIndexed } from "./db.js";
+export function getContinueSessionsDir() {
+    const base = process.env.KIT_CONTINUE_DIR ?? join(homedir(), ".continue");
+    return join(base, "sessions");
+}
+/** Flatten Continue MessageContent (string or part array) to plain text. */
+function contentText(content) {
+    if (typeof content === "string")
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((p) => (p?.type === "text" ? (p.text ?? "") : ""))
+            .filter(Boolean)
+            .join("\n");
+    }
+    return "";
+}
+function indexFile(db, filepath) {
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(filepath, "utf8"));
+    }
+    catch {
+        return { messages: 0 };
+    }
+    if (parsed === null || typeof parsed !== "object")
+        return { messages: 0 };
+    const session = parsed;
+    if (!Array.isArray(session.history))
+        return { messages: 0 }; // not a Session (e.g. the index)
+    const id = session.sessionId ?? basename(filepath, ".json");
+    const sessionId = `continue:${id}`;
+    const cwd = session.workspaceDirectory || undefined;
+    upsertSession(db, {
+        sessionId,
+        harness: "continue",
+        project: cwd ? basename(cwd) : undefined,
+    });
+    let messages = 0;
+    session.history.forEach((item, idx) => {
+        const role = item?.message?.role;
+        if (role !== "user" && role !== "assistant")
+            return; // skip system/thinking/tool
+        const text = contentText(item.message?.content);
+        if (!text)
+            return;
+        const added = insertMessage(db, {
+            uuid: `continue:${id}:${idx}`,
+            sessionId,
+            type: role,
+            role,
+            content: text,
+            cwd,
+        });
+        if (added)
+            messages++;
+    });
+    return { messages };
+}
+/** Walk ~/.continue/sessions and index every session JSON. Idempotent + incremental. */
+export function indexContinueSessions(db) {
+    const dir = getContinueSessionsDir();
+    const result = { files: 0, sessions: 0, messages: 0, toolUses: 0, filesSkipped: 0 };
+    if (!existsSync(dir))
+        return result;
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return result;
+    }
+    for (const e of entries) {
+        if (!e.isFile() || !e.name.endsWith(".json") || e.name === "sessions.json")
+            continue;
+        const filepath = join(dir, e.name);
+        let st;
+        try {
+            st = statSync(filepath);
+        }
+        catch {
+            continue;
+        }
+        const mtimeMs = Math.floor(st.mtimeMs);
+        if (isFileIndexed(db, filepath, mtimeMs, st.size)) {
+            result.filesSkipped++;
+            continue;
+        }
+        const counts = indexFile(db, filepath);
+        markFileIndexed(db, filepath, mtimeMs, st.size);
+        result.files++;
+        result.sessions++;
+        result.messages += counts.messages;
+    }
+    return result;
+}
+//# sourceMappingURL=continue.js.map

package/dist/memory/continue.js.map

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

package/dist/memory/cursor.d.ts

@@ -0,0 +1,4 @@
+import { DatabaseSync } from "node:sqlite";
+import type { IndexResult } from "./parser.js";
+export declare function getCursorStateDb(): string;
+export declare function indexCursorSessions(db: DatabaseSync): IndexResult;

package/dist/memory/cursor.js

@@ -0,0 +1,116 @@
+/**
+ * kit memory — Cursor transcript parser (multi-harness).
+ *
+ * Cursor stores chat in a SQLite DB at globalStorage/state.vscdb, table
+ * `cursorDiskKV`: one row per "bubble" (message), keyed
+ * `bubbleId:<composerId>:<bubbleId>`, plus `composerData:<id>` session metadata.
+ * The bubble value is JSON with `type` (1 = user, 2 = assistant) and `text`.
+ *
+ * Cursor's store is APP-INTERNAL and community-reverse-engineered (not an
+ * official schema), so this parser is deliberately DEFENSIVE: it maps only the
+ * known fields and, if the table or shape ever differs, indexes nothing rather
+ * than guessing — it can never write WRONG data, only less of it. Read-only,
+ * idempotent (uuid = the bubble key), fail-safe, no model calls.
+ *
+ * Limitation: Cursor keys by composerId, not project path — messages carry no
+ * cwd and surface in `--global` recall, not project-scoped search.
+ */
+import { existsSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { DatabaseSync } from "node:sqlite";
+import { insertMessage, upsertSession, isFileIndexed, markFileIndexed } from "./db.js";
+export function getCursorStateDb() {
+    if (process.env.KIT_CURSOR_DB)
+        return process.env.KIT_CURSOR_DB;
+    const home = homedir();
+    const sub = join("Cursor", "User", "globalStorage", "state.vscdb");
+    switch (process.platform) {
+        case "darwin":
+            return join(home, "Library", "Application Support", sub);
+        case "win32":
+            return join(process.env.APPDATA ?? join(home, "AppData", "Roaming"), sub);
+        default:
+            return join(home, ".config", sub);
+    }
+}
+/** key = "bubbleId:<composerId>:<bubbleId>" → composerId */
+function composerIdFromKey(key) {
+    return key.split(":")[1] ?? "unknown";
+}
+export function indexCursorSessions(db) {
+    const result = { files: 0, sessions: 0, messages: 0, toolUses: 0, filesSkipped: 0 };
+    const dbPath = getCursorStateDb();
+    if (!existsSync(dbPath))
+        return result;
+    let st;
+    try {
+        st = statSync(dbPath);
+    }
+    catch {
+        return result;
+    }
+    const mtimeMs = Math.floor(st.mtimeMs);
+    if (isFileIndexed(db, dbPath, mtimeMs, st.size)) {
+        result.filesSkipped++;
+        return result;
+    }
+    let src;
+    try {
+        src = new DatabaseSync(dbPath, { readOnly: true });
+    }
+    catch {
+        return result; // locked / unreadable while Cursor runs → fail-safe, retry next run
+    }
+    try {
+        let rows;
+        try {
+            rows = src
+                .prepare("SELECT key, value FROM cursorDiskKV WHERE key LIKE 'bubbleId:%'")
+                .all();
+        }
+        catch {
+            // table absent / schema differs → fail-safe (index nothing, never wrong data)
+            markFileIndexed(db, dbPath, mtimeMs, st.size);
+            return result;
+        }
+        const sessionsSeen = new Set();
+        for (const row of rows) {
+            let bubble;
+            try {
+                bubble = JSON.parse(row.value);
+            }
+            catch {
+                continue;
+            }
+            if (bubble.type !== 1 && bubble.type !== 2)
+                continue; // only user/assistant turns
+            const text = typeof bubble.text === "string" ? bubble.text.trim() : "";
+            if (!text)
+                continue; // tool-only / empty bubbles carry no searchable text
+            const sessionId = `cursor:${composerIdFromKey(row.key)}`;
+            if (!sessionsSeen.has(sessionId)) {
+                upsertSession(db, { sessionId, harness: "cursor" });
+                sessionsSeen.add(sessionId);
+            }
+            const role = bubble.type === 1 ? "user" : "assistant";
+            const added = insertMessage(db, {
+                uuid: `cursor:${row.key}`, // stable per bubble → idempotent
+                sessionId,
+                type: role,
+                role,
+                content: text,
+            });
+            if (added)
+                result.messages++;
+        }
+        result.sessions += sessionsSeen.size;
+        result.files++;
+    }
+    finally {
+        src.close();
+    }
+    markFileIndexed(db, dbPath, mtimeMs, st.size);
+    return result;
+}
+//# sourceMappingURL=cursor.js.map

package/dist/memory/cursor.js.map

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

package/dist/memory/db.d.ts

@@ -14,7 +14,7 @@
  */
 import { DatabaseSync } from "node:sqlite";
 import type { MemoryStats, MessageInput, SearchHit, SessionInput, ToolUseInput } from "./types.js";
-export declare const SCHEMA_VERSION = 2;
+export declare const SCHEMA_VERSION = 3;
 export declare function getMemoryDir(): string;
 export declare function getMemoryDbPath(): string;
 /**
@@ -22,6 +22,10 @@ export declare function getMemoryDbPath(): string;
  * an ephemeral in-process DB (tests). Otherwise defaults to ~/.kit/memory.db.
  */
 export declare function openMemoryDb(path?: string): DatabaseSync;
+/** Has this file already been indexed at exactly this mtime + size? (incremental index) */
+export declare function isFileIndexed(db: DatabaseSync, path: string, mtimeMs: number, size: number): boolean;
+/** Record (or refresh) a file's mtime + size after indexing it. */
+export declare function markFileIndexed(db: DatabaseSync, path: string, mtimeMs: number, size: number): void;
 export declare function upsertSession(db: DatabaseSync, s: SessionInput): void;
 /** Insert a message idempotently (by uuid). Returns true if a new row was added. */
 export declare function insertMessage(db: DatabaseSync, m: MessageInput): boolean;
@@ -37,4 +41,11 @@ export interface SearchOptions {
  * for cross-project ("--global") recall over the personal store.
  */
 export declare function searchMessages(db: DatabaseSync, query: string, opts?: SearchOptions): SearchHit[];
+/**
+ * Most-recent messages by wall-clock time (newest first) — the basis for session
+ * recovery (re-injecting "where you left off" after a compaction/resume). Unlike
+ * searchMessages this needs no query; pass opts.projectPath to scope to one repo.
+ * Skips empty-content rows so the recovery block stays signal, not blank tool turns.
+ */
+export declare function recentMessages(db: DatabaseSync, opts?: SearchOptions): SearchHit[];
 export declare function getStats(db: DatabaseSync): MemoryStats;

package/dist/memory/db.js

@@ -16,7 +16,7 @@ import { DatabaseSync } from "node:sqlite";
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { existsSync, mkdirSync, chmodSync, statSync } from "node:fs";
-export const SCHEMA_VERSION = 2;
+export const SCHEMA_VERSION = 3;
 export function getMemoryDir() {
     return process.env.KIT_MEMORY_DIR ?? join(homedir(), ".kit");
 }
@@ -89,6 +89,13 @@ CREATE TABLE IF NOT EXISTS pending_actions (
   verify_passes INTEGER NOT NULL DEFAULT 0
 );
 
+CREATE TABLE IF NOT EXISTS file_index (
+  path TEXT PRIMARY KEY,
+  mtime_ms INTEGER NOT NULL,
+  size INTEGER NOT NULL,
+  indexed_at TEXT DEFAULT CURRENT_TIMESTAMP
+);
+
 CREATE INDEX IF NOT EXISTS idx_messages_session ON messages(session_id);
 CREATE INDEX IF NOT EXISTS idx_messages_type ON messages(type);
 CREATE INDEX IF NOT EXISTS idx_messages_timestamp ON messages(timestamp);
@@ -155,6 +162,18 @@ export function openMemoryDb(path) {
     }
     return db;
 }
+/** Has this file already been indexed at exactly this mtime + size? (incremental index) */
+export function isFileIndexed(db, path, mtimeMs, size) {
+    return !!db
+        .prepare("SELECT 1 FROM file_index WHERE path = ? AND mtime_ms = ? AND size = ?")
+        .get(path, mtimeMs, size);
+}
+/** Record (or refresh) a file's mtime + size after indexing it. */
+export function markFileIndexed(db, path, mtimeMs, size) {
+    db.prepare(`INSERT INTO file_index (path, mtime_ms, size, indexed_at)
+     VALUES (?, ?, ?, datetime('now'))
+     ON CONFLICT(path) DO UPDATE SET mtime_ms = excluded.mtime_ms, size = excluded.size, indexed_at = datetime('now')`).run(path, mtimeMs, size);
+}
 export function upsertSession(db, s) {
     db.prepare(`INSERT INTO sessions (session_id, harness, project, first_message_at, last_message_at, is_agent_sidechain)
      VALUES (?, ?, ?, ?, ?, ?)
@@ -206,6 +225,29 @@ export function searchMessages(db, query, opts = {}) {
        LIMIT ?`)
         .all(...params);
 }
+/**
+ * Most-recent messages by wall-clock time (newest first) — the basis for session
+ * recovery (re-injecting "where you left off" after a compaction/resume). Unlike
+ * searchMessages this needs no query; pass opts.projectPath to scope to one repo.
+ * Skips empty-content rows so the recovery block stays signal, not blank tool turns.
+ */
+export function recentMessages(db, opts = {}) {
+    const limit = opts.limit ?? 10;
+    const params = [];
+    let where = "content IS NOT NULL AND content != ''";
+    if (opts.projectPath) {
+        where += " AND (cwd = ? OR cwd LIKE ?)";
+        params.push(opts.projectPath, `${opts.projectPath}/%`);
+    }
+    params.push(limit);
+    return db
+        .prepare(`SELECT id, uuid, session_id AS sessionId, role, content, timestamp
+       FROM messages
+       WHERE ${where}
+       ORDER BY timestamp DESC, id DESC
+       LIMIT ?`)
+        .all(...params);
+}
 export function getStats(db) {
     const count = (sql) => {
         const r = db.prepare(sql).get();