@aeriondyseti/vector-memory-mcp 1.0.2-dev.0 → 1.1.0-dev.2

package/dist/src/services/session-parser.js

@@ -0,0 +1,147 @@
+import { createReadStream } from "fs";
+import { readdir, stat } from "fs/promises";
+import { createInterface } from "readline";
+import { basename, join } from "path";
+import { randomUUID } from "crypto";
+/**
+ * Extract the text content from a JSONL message line.
+ * - User messages: content is string OR array (skip tool_result blocks)
+ * - Assistant messages: content is array of blocks (keep only type=text)
+ * Returns null if no usable text content.
+ */
+function extractTextContent(line) {
+    const content = line.message?.content;
+    if (content == null)
+        return null;
+    // User messages can be a plain string
+    if (typeof content === "string") {
+        return content.trim() || null;
+    }
+    // Array of content blocks — extract text blocks only
+    const textParts = [];
+    for (const block of content) {
+        if (block.type === "text" && block.text) {
+            textParts.push(block.text);
+        }
+    }
+    const joined = textParts.join("\n").trim();
+    return joined || null;
+}
+/**
+ * Parse a single Claude Code JSONL session file.
+ *
+ * @param filePath - Absolute path to the .jsonl file
+ * @param fromByte - Byte offset to start reading from (for incremental parsing).
+ *                   When non-zero, messageIndex starts from startIndex.
+ * @param startIndex - Starting message index (for incremental parsing).
+ * @param knownFileSize - If already known (e.g. from discoverSessionFiles), avoids a redundant stat().
+ */
+export async function parseSessionFile(filePath, fromByte = 0, startIndex = 0, knownFileSize) {
+    const fileSize = knownFileSize ?? (await stat(filePath)).size;
+    // Extract session ID from filename (e.g. "abc-123.jsonl" → "abc-123")
+    const sessionId = basename(filePath, ".jsonl");
+    const messages = [];
+    let messageIndex = startIndex;
+    let firstMessageAt = null;
+    let lastMessageAt = null;
+    let gitBranch = null;
+    let project = null;
+    const stream = createReadStream(filePath, {
+        encoding: "utf-8",
+        start: fromByte,
+    });
+    const rl = createInterface({ input: stream, crlfDelay: Infinity });
+    for await (const rawLine of rl) {
+        if (!rawLine.trim())
+            continue;
+        let line;
+        try {
+            line = JSON.parse(rawLine);
+        }
+        catch {
+            // Skip malformed lines
+            continue;
+        }
+        // Only process user and assistant messages
+        if (line.type !== "user" && line.type !== "assistant")
+            continue;
+        // Capture metadata from first line that has it
+        if (gitBranch == null && line.gitBranch)
+            gitBranch = line.gitBranch;
+        if (project == null && line.cwd)
+            project = line.cwd;
+        const role = line.type === "user" ? "user" : "assistant";
+        const text = extractTextContent(line);
+        if (!text)
+            continue;
+        const timestamp = line.timestamp ? new Date(line.timestamp) : new Date();
+        if (firstMessageAt == null)
+            firstMessageAt = timestamp;
+        lastMessageAt = timestamp;
+        messages.push({
+            id: randomUUID(),
+            sessionId,
+            role,
+            messageIndex,
+            content: text,
+            timestamp,
+            metadata: {
+                ...(line.gitBranch ? { gitBranch: line.gitBranch } : {}),
+                ...(line.cwd ? { cwd: line.cwd } : {}),
+            },
+        });
+        messageIndex++;
+    }
+    return {
+        sessionId,
+        filePath,
+        fileSize,
+        messages,
+        firstMessageAt,
+        lastMessageAt,
+        gitBranch,
+        project,
+    };
+}
+/**
+ * Discover all .jsonl session files in a directory.
+ * Stat calls are parallelized for efficiency.
+ */
+export async function discoverSessionFiles(sessionDir) {
+    let entries;
+    try {
+        entries = await readdir(sessionDir);
+    }
+    catch {
+        return [];
+    }
+    const jsonlEntries = entries.filter((e) => e.endsWith(".jsonl"));
+    const settled = await Promise.allSettled(jsonlEntries.map(async (entry) => {
+        const filePath = join(sessionDir, entry);
+        const fileStats = await stat(filePath);
+        if (!fileStats.isFile())
+            return null;
+        return {
+            sessionId: entry.replace(/\.jsonl$/, ""),
+            filePath,
+            fileSize: fileStats.size,
+        };
+    }));
+    return settled
+        .filter((r) => r.status === "fulfilled")
+        .map((r) => r.value)
+        .filter((v) => v != null);
+}
+/**
+ * Auto-detect the Claude Code sessions directory.
+ * Returns null if not found.
+ */
+export function detectSessionPath() {
+    const home = process.env.HOME ?? process.env.USERPROFILE;
+    if (!home)
+        return null;
+    // Claude Code stores sessions at ~/.claude/projects/<project-slug>/<session-id>.jsonl
+    // We return the projects dir — the caller iterates project subdirs
+    return join(home, ".claude", "projects");
+}
+//# sourceMappingURL=session-parser.js.map

package/dist/src/services/session-parser.js.map

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

package/dist/src/types/conversation-history.d.ts

@@ -0,0 +1,74 @@
+import type { WithRrfScore } from "./memory.js";
+export type MessageRole = "user" | "assistant";
+/**
+ * A single indexed message from a conversation session log.
+ * One entry per user/assistant text message — tool calls and results are excluded.
+ */
+export interface ConversationHistoryEntry {
+    id: string;
+    content: string;
+    embedding: number[];
+    sessionId: string;
+    role: MessageRole;
+    messageIndex: number;
+    timestamp: Date;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+}
+export type ConversationHistoryHybridRow = WithRrfScore<ConversationHistoryEntry>;
+/**
+ * Summary of an indexed session for list_indexed_sessions.
+ */
+export interface IndexedSessionSummary {
+    sessionId: string;
+    messageCount: number;
+    firstMessageAt: Date;
+    lastMessageAt: Date;
+    indexedAt: Date;
+    project?: string;
+    gitBranch?: string;
+}
+/**
+ * Full indexed session record including storage-level fields (file path, size).
+ * Used by the repository for upsert operations and by the parser for tracking.
+ */
+export interface IndexedSession extends IndexedSessionSummary {
+    filePath: string;
+    fileSize: number;
+}
+/**
+ * Discriminated union for merged search results.
+ * Narrow on `source` to access type-specific fields.
+ */
+export interface MemorySearchResult {
+    source: "memory";
+    id: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    score: number;
+    createdAt: Date;
+    updatedAt: Date;
+    supersededBy: string | null;
+}
+export interface HistorySearchResult {
+    source: "conversation_history";
+    id: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    score: number;
+    sessionId: string;
+    role: MessageRole;
+    messageIndex: number;
+    timestamp: Date;
+}
+export type SearchResult = MemorySearchResult | HistorySearchResult;
+/**
+ * Summary returned by indexConversations() and reindexSession().
+ */
+export interface IndexingSummary {
+    sessionsDiscovered: number;
+    sessionsIndexed: number;
+    sessionsSkipped: number;
+    messagesIndexed: number;
+}
+//# sourceMappingURL=conversation-history.d.ts.map

package/dist/src/types/conversation-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.d.ts","sourceRoot":"","sources":["../../../src/types/conversation-history.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,4BAA4B,GAAG,YAAY,CAAC,wBAAwB,CAAC,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,IAAI,CAAC;IACrB,aAAa,EAAE,IAAI,CAAC;IACpB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAe,SAAQ,qBAAqB;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,QAAQ,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,WAAW,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/src/types/conversation-history.js

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

package/dist/src/types/conversation-history.js.map

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

package/dist/src/types/memory.d.ts

@@ -22,7 +22,9 @@ export interface IntentProfile {
     };
     jitter: number;
 }
-export interface HybridRow extends Memory {
+/** Augments any entity type with an RRF score from hybrid search. */
+export type WithRrfScore<T> = T & {
     rrfScore: number;
-}
+};
+export type HybridRow = WithRrfScore<Memory>;
 //# sourceMappingURL=memory.d.ts.map

package/dist/src/types/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/types/memory.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYpE;AAED,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAEhG,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAU,SAAQ,MAAM;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../src/types/memory.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAE3C,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,IAAI,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYpE;AAED,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;AAEhG,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeriondyseti/vector-memory-mcp",
-  "version": "1.0.2-dev.0",
+  "version": "1.1.0-dev.2",
   "description": "A zero-configuration RAG memory server for MCP clients",
   "type": "module",
   "main": "dist/src/index.js",
@@ -17,13 +17,13 @@
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/AerionDyseti/vector-memory-mcp.git"
+    "url": "https://github.com/aeriondyseti/vector-memory-mcp"
   },
   "author": "AerionDyseti",
   "bugs": {
-    "url": "https://github.com/AerionDyseti/vector-memory-mcp/issues"
+    "url": "https://github.com/aeriondyseti/vector-memory-mcp/issues"
   },
-  "homepage": "https://github.com/AerionDyseti/vector-memory-mcp#readme",
+  "homepage": "https://github.com/aeriondyseti/vector-memory-mcp#readme",
   "scripts": {
     "start": "node dist/src/index.js",
     "start:bun": "bun run src/index.ts",

package/src/config/index.ts

@@ -14,6 +14,11 @@ export interface Config {
   httpHost: string;
   enableHttp: boolean;
   transportMode: TransportMode;
+  conversationHistory: {
+    enabled: boolean;
+    sessionPath: string | null; // null = auto-detect Claude Code session dir
+    historyWeight: number; // 0.0-1.0, applied to history scores when merging with memories
+  };
 }
 
 export interface ConfigOverrides {
@@ -21,6 +26,11 @@ export interface ConfigOverrides {
   httpPort?: number;
   enableHttp?: boolean;
   transportMode?: TransportMode;
+  conversationHistory?: {
+    enabled?: boolean;
+    sessionPath?: string;
+    historyWeight?: number;
+  };
 }
 
 // Defaults - always use repo-local .vector-memory folder
@@ -47,6 +57,11 @@ export function loadConfig(overrides: ConfigOverrides = {}): Config {
     httpHost: DEFAULT_HTTP_HOST,
     enableHttp,
     transportMode,
+    conversationHistory: {
+      enabled: overrides.conversationHistory?.enabled ?? false,
+      sessionPath: overrides.conversationHistory?.sessionPath ?? null,
+      historyWeight: overrides.conversationHistory?.historyWeight ?? 0.5,
+    },
   };
 }
 
@@ -59,6 +74,8 @@ export function parseCliArgs(argv: string[]): ConfigOverrides {
       "--db-file": String,
       "--port": Number,
       "--no-http": Boolean,
+      "--conversation-history": Boolean,
+      "--session-path": String,
 
       // Aliases
       "-d": "--db-file",
@@ -71,6 +88,12 @@ export function parseCliArgs(argv: string[]): ConfigOverrides {
     dbPath: args["--db-file"],
     httpPort: args["--port"],
     enableHttp: args["--no-http"] ? false : undefined,
+    conversationHistory: args["--conversation-history"] || args["--session-path"]
+      ? {
+          enabled: args["--conversation-history"],
+          sessionPath: args["--session-path"],
+        }
+      : undefined,
   };
 }
 

package/src/db/conversation-history.repository.ts

@@ -0,0 +1,255 @@
+import * as lancedb from "@lancedb/lancedb";
+import { type Table } from "@lancedb/lancedb";
+import {
+  CONVERSATION_HISTORY_TABLE,
+  INDEXED_SESSIONS_TABLE,
+  conversationHistorySchema,
+  indexedSessionsSchema,
+} from "./conversation-history.schema.js";
+import {
+  arrowVectorToArray,
+  getOrCreateTable,
+  createFtsMutex,
+  createRerankerMutex,
+  escapeLanceDbString,
+} from "./lancedb-utils.js";
+import type {
+  ConversationHistoryEntry,
+  ConversationHistoryHybridRow,
+  IndexedSession,
+  IndexedSessionSummary,
+  MessageRole,
+} from "../types/conversation-history.js";
+
+export class ConversationHistoryRepository {
+  // Cached table handles — initialized once, retained for instance lifetime
+  private tablePromise: Promise<Table> | null = null;
+  private sessionsTablePromise: Promise<Table> | null = null;
+
+  // FTS index mutex — once created, the promise is never cleared (index persists in LanceDB)
+  private ensureFtsIndex: () => Promise<void>;
+
+  // Cached reranker — k=60 is constant, no need to recreate per search
+  private getReranker = createRerankerMutex();
+
+  constructor(private db: lancedb.Connection) {
+    this.ensureFtsIndex = createFtsMutex(() => this.getTable());
+  }
+
+  private getTable(): Promise<Table> {
+    if (!this.tablePromise) {
+      this.tablePromise = getOrCreateTable(
+        this.db,
+        CONVERSATION_HISTORY_TABLE,
+        conversationHistorySchema
+      ).catch((e) => {
+        this.tablePromise = null;
+        throw e;
+      });
+    }
+    return this.tablePromise;
+  }
+
+  private getSessionsTable(): Promise<Table> {
+    if (!this.sessionsTablePromise) {
+      this.sessionsTablePromise = getOrCreateTable(
+        this.db,
+        INDEXED_SESSIONS_TABLE,
+        indexedSessionsSchema
+      ).catch((e) => {
+        this.sessionsTablePromise = null;
+        throw e;
+      });
+    }
+    return this.sessionsTablePromise;
+  }
+
+  private rowToEntry(row: Record<string, unknown>): ConversationHistoryEntry {
+    return {
+      id: row.id as string,
+      content: row.content as string,
+      embedding: arrowVectorToArray(row.vector),
+      sessionId: row.session_id as string,
+      role: row.role as MessageRole,
+      messageIndex: row.message_index as number,
+      timestamp: new Date(row.timestamp as number),
+      metadata: JSON.parse(row.metadata as string),
+      createdAt: new Date(row.created_at as number),
+    };
+  }
+
+  private rowToSessionSummary(
+    row: Record<string, unknown>
+  ): IndexedSessionSummary {
+    return {
+      sessionId: row.session_id as string,
+      messageCount: row.message_count as number,
+      firstMessageAt: new Date(row.first_message_at as number),
+      lastMessageAt: new Date(row.last_message_at as number),
+      indexedAt: new Date(row.indexed_at as number),
+      // Use null check (not truthiness) — empty string is a valid value distinct from null
+      ...(row.project != null ? { project: row.project as string } : {}),
+      ...(row.git_branch != null ? { gitBranch: row.git_branch as string } : {}),
+    };
+  }
+
+  private rowToSession(row: Record<string, unknown>): IndexedSession {
+    return {
+      ...this.rowToSessionSummary(row),
+      filePath: row.file_path as string,
+      fileSize: row.file_size as number,
+    };
+  }
+
+  // --- Conversation History Operations ---
+
+  async insert(entries: ConversationHistoryEntry[]): Promise<void> {
+    if (entries.length === 0) return;
+
+    const table = await this.getTable();
+    await table.add(
+      entries.map((entry) => ({
+        id: entry.id,
+        vector: entry.embedding,
+        content: entry.content,
+        session_id: entry.sessionId,
+        role: entry.role,
+        message_index: entry.messageIndex,
+        timestamp: entry.timestamp.getTime(),
+        metadata: JSON.stringify(entry.metadata),
+        created_at: entry.createdAt.getTime(),
+      }))
+    );
+  }
+
+  async findHybrid(
+    embedding: number[],
+    query: string,
+    limit: number
+  ): Promise<ConversationHistoryHybridRow[]> {
+    await this.ensureFtsIndex();
+
+    const table = await this.getTable();
+    const reranker = await this.getReranker();
+
+    const results = await table
+      .query()
+      .nearestTo(embedding)
+      .fullTextSearch(query)
+      .rerank(reranker)
+      .limit(limit)
+      .toArray();
+
+    return results.map((row) => {
+      const entry = this.rowToEntry(row as Record<string, unknown>);
+      return {
+        ...entry,
+        rrfScore: (row._relevance_score as number) ?? 0,
+      };
+    });
+  }
+
+  async findBySessionId(sessionId: string): Promise<ConversationHistoryEntry[]> {
+    const table = await this.getTable();
+    const results = await table
+      .query()
+      .where(`session_id = '${escapeLanceDbString(sessionId)}'`)
+      .toArray();
+
+    return results.map((row) =>
+      this.rowToEntry(row as Record<string, unknown>)
+    );
+  }
+
+  async deleteBySessionId(sessionId: string): Promise<number> {
+    const table = await this.getTable();
+
+    // Select only id — avoids deserializing embedding vectors just for a count
+    const existing = await table
+      .query()
+      .where(`session_id = '${escapeLanceDbString(sessionId)}'`)
+      .select(["id"])
+      .toArray();
+    const count = existing.length;
+
+    if (count > 0) {
+      await table.delete(`session_id = '${escapeLanceDbString(sessionId)}'`);
+    }
+
+    return count;
+  }
+
+  // --- Indexed Sessions Tracking ---
+
+  async getIndexedSession(
+    sessionId: string
+  ): Promise<IndexedSession | null> {
+    const table = await this.getSessionsTable();
+    const results = await table
+      .query()
+      .where(`session_id = '${escapeLanceDbString(sessionId)}'`)
+      .limit(1)
+      .toArray();
+
+    if (results.length === 0) {
+      return null;
+    }
+
+    return this.rowToSession(results[0] as Record<string, unknown>);
+  }
+
+  async upsertIndexedSession(session: IndexedSession): Promise<void> {
+    const table = await this.getSessionsTable();
+    const existing = await table
+      .query()
+      .where(`session_id = '${escapeLanceDbString(session.sessionId)}'`)
+      .limit(1)
+      .toArray();
+
+    const row = {
+      session_id: session.sessionId,
+      file_path: session.filePath,
+      file_size: session.fileSize,
+      message_count: session.messageCount,
+      first_message_at: session.firstMessageAt.getTime(),
+      last_message_at: session.lastMessageAt.getTime(),
+      indexed_at: session.indexedAt.getTime(),
+      project: session.project ?? null,
+      git_branch: session.gitBranch ?? null,
+    };
+
+    if (existing.length === 0) {
+      await table.add([row]);
+    } else {
+      await table.update({
+        where: `session_id = '${escapeLanceDbString(session.sessionId)}'`,
+        values: row,
+      });
+    }
+  }
+
+  async listIndexedSessions(): Promise<IndexedSessionSummary[]> {
+    const table = await this.getSessionsTable();
+    const results = await table.query().toArray();
+
+    return results.map((row) =>
+      this.rowToSessionSummary(row as Record<string, unknown>)
+    );
+  }
+
+  async deleteIndexedSession(sessionId: string): Promise<boolean> {
+    const table = await this.getSessionsTable();
+    const existing = await table
+      .query()
+      .where(`session_id = '${escapeLanceDbString(sessionId)}'`)
+      .limit(1)
+      .toArray();
+
+    if (existing.length === 0) {
+      return false;
+    }
+
+    await table.delete(`session_id = '${escapeLanceDbString(sessionId)}'`);
+    return true;
+  }
+}

package/src/db/conversation-history.schema.ts

@@ -0,0 +1,40 @@
+import {
+  Schema,
+  Field,
+  Utf8,
+  Int32,
+  Float64,
+} from "apache-arrow";
+import { vectorField, timestampField } from "./schema.js";
+
+export const CONVERSATION_HISTORY_TABLE = "conversation_history";
+
+/**
+ * Tracks which sessions have been indexed and their file sizes,
+ * enabling idempotent incremental indexing.
+ */
+export const INDEXED_SESSIONS_TABLE = "indexed_sessions";
+
+export const conversationHistorySchema = new Schema([
+  new Field("id", new Utf8(), false),
+  vectorField(),
+  new Field("content", new Utf8(), false),
+  new Field("session_id", new Utf8(), false),
+  new Field("role", new Utf8(), false), // "user" | "assistant"
+  new Field("message_index", new Int32(), false),
+  timestampField("timestamp"),
+  new Field("metadata", new Utf8(), false), // JSON string
+  timestampField("created_at"),
+]);
+
+export const indexedSessionsSchema = new Schema([
+  new Field("session_id", new Utf8(), false),
+  new Field("file_path", new Utf8(), false),
+  new Field("file_size", new Float64(), false), // Float64 avoids Int32 overflow and BigInt handling
+  new Field("message_count", new Int32(), false),
+  timestampField("first_message_at"),
+  timestampField("last_message_at"),
+  timestampField("indexed_at"),
+  new Field("project", new Utf8(), true), // Nullable
+  new Field("git_branch", new Utf8(), true), // Nullable
+]);