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

package/dist/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/dist/src/config/index.d.ts

@@ -8,12 +8,22 @@ export interface Config {
     httpHost: string;
     enableHttp: boolean;
     transportMode: TransportMode;
+    conversationHistory: {
+        enabled: boolean;
+        sessionPath: string | null;
+        historyWeight: number;
+    };
 }
 export interface ConfigOverrides {
     dbPath?: string;
     httpPort?: number;
     enableHttp?: boolean;
     transportMode?: TransportMode;
+    conversationHistory?: {
+        enabled?: boolean;
+        sessionPath?: string;
+        historyWeight?: number;
+    };
 }
 export declare function loadConfig(overrides?: ConfigOverrides): Config;
 /**

package/dist/src/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,QAAsB,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAaD,wBAAgB,UAAU,CAAC,SAAS,GAAE,eAAoB,GAAG,MAAM,CAclE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CAmB5D;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,OAAO,QAAsB,CAAC;AAE3C,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,aAAa,CAAC;IAC7B,mBAAmB,EAAE;QACnB,OAAO,EAAE,OAAO,CAAC;QACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,mBAAmB,CAAC,EAAE;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAaD,wBAAgB,UAAU,CAAC,SAAS,GAAE,eAAoB,GAAG,MAAM,CAmBlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA2B5D;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/src/config/index.js

@@ -23,6 +23,11 @@ export function loadConfig(overrides = {}) {
         httpHost: DEFAULT_HTTP_HOST,
         enableHttp,
         transportMode,
+        conversationHistory: {
+            enabled: overrides.conversationHistory?.enabled ?? false,
+            sessionPath: overrides.conversationHistory?.sessionPath ?? null,
+            historyWeight: overrides.conversationHistory?.historyWeight ?? 0.5,
+        },
     };
 }
 /**
@@ -33,6 +38,8 @@ export function parseCliArgs(argv) {
         "--db-file": String,
         "--port": Number,
         "--no-http": Boolean,
+        "--conversation-history": Boolean,
+        "--session-path": String,
         // Aliases
         "-d": "--db-file",
         "-p": "--port",
@@ -41,6 +48,12 @@ export function parseCliArgs(argv) {
         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,
     };
 }
 // Default config for imports that don't use CLI args

package/dist/src/config/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEnE,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;AAqB3C,yDAAyD;AACzD,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;AAC7E,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAC1D,MAAM,2BAA2B,GAAG,GAAG,CAAC;AACxC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAEtC,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,YAA6B,EAAE;IACxD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,IAAI,OAAO,CAAC;IACzD,yEAAyE;IACzE,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,IAAI,IAAI,CAAC;IAEhD,OAAO;QACL,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,MAAM,IAAI,eAAe,CAAC;QACxD,cAAc,EAAE,uBAAuB;QACvC,kBAAkB,EAAE,2BAA2B;QAC/C,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,iBAAiB;QACjD,QAAQ,EAAE,iBAAiB;QAC3B,UAAU;QACV,aAAa;KACd,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,IAAI,GAAG,GAAG,CACd;QACE,WAAW,EAAE,MAAM;QACnB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,OAAO;QAEpB,UAAU;QACV,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;KACf,EACD,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAC3B,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;QACxB,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KAClD,CAAC;AACJ,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,WAAW,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEnE,MAAM,CAAC,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;AA+B3C,yDAAyD;AACzD,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;AAC7E,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAC1D,MAAM,2BAA2B,GAAG,GAAG,CAAC;AACxC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAEtC,SAAS,WAAW,CAAC,IAAY;IAC/B,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,YAA6B,EAAE;IACxD,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,IAAI,OAAO,CAAC;IACzD,yEAAyE;IACzE,MAAM,UAAU,GAAG,SAAS,CAAC,UAAU,IAAI,IAAI,CAAC;IAEhD,OAAO;QACL,MAAM,EAAE,WAAW,CAAC,SAAS,CAAC,MAAM,IAAI,eAAe,CAAC;QACxD,cAAc,EAAE,uBAAuB;QACvC,kBAAkB,EAAE,2BAA2B;QAC/C,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,iBAAiB;QACjD,QAAQ,EAAE,iBAAiB;QAC3B,UAAU;QACV,aAAa;QACb,mBAAmB,EAAE;YACnB,OAAO,EAAE,SAAS,CAAC,mBAAmB,EAAE,OAAO,IAAI,KAAK;YACxD,WAAW,EAAE,SAAS,CAAC,mBAAmB,EAAE,WAAW,IAAI,IAAI;YAC/D,aAAa,EAAE,SAAS,CAAC,mBAAmB,EAAE,aAAa,IAAI,GAAG;SACnE;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,IAAI,GAAG,GAAG,CACd;QACE,WAAW,EAAE,MAAM;QACnB,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,OAAO;QACpB,wBAAwB,EAAE,OAAO;QACjC,gBAAgB,EAAE,MAAM;QAExB,UAAU;QACV,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,QAAQ;KACf,EACD,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAC3B,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC;QACxB,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QACjD,mBAAmB,EAAE,IAAI,CAAC,wBAAwB,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC;YAC3E,CAAC,CAAC;gBACE,OAAO,EAAE,IAAI,CAAC,wBAAwB,CAAC;gBACvC,WAAW,EAAE,IAAI,CAAC,gBAAgB,CAAC;aACpC;YACH,CAAC,CAAC,SAAS;KACd,CAAC;AACJ,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC"}

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

@@ -0,0 +1,24 @@
+import * as lancedb from "@lancedb/lancedb";
+import type { ConversationHistoryEntry, ConversationHistoryHybridRow, IndexedSession, IndexedSessionSummary } from "../types/conversation-history.js";
+export declare class ConversationHistoryRepository {
+    private db;
+    private tablePromise;
+    private sessionsTablePromise;
+    private ensureFtsIndex;
+    private getReranker;
+    constructor(db: lancedb.Connection);
+    private getTable;
+    private getSessionsTable;
+    private rowToEntry;
+    private rowToSessionSummary;
+    private rowToSession;
+    insert(entries: ConversationHistoryEntry[]): Promise<void>;
+    findHybrid(embedding: number[], query: string, limit: number): Promise<ConversationHistoryHybridRow[]>;
+    findBySessionId(sessionId: string): Promise<ConversationHistoryEntry[]>;
+    deleteBySessionId(sessionId: string): Promise<number>;
+    getIndexedSession(sessionId: string): Promise<IndexedSession | null>;
+    upsertIndexedSession(session: IndexedSession): Promise<void>;
+    listIndexedSessions(): Promise<IndexedSessionSummary[]>;
+    deleteIndexedSession(sessionId: string): Promise<boolean>;
+}
+//# sourceMappingURL=conversation-history.repository.d.ts.map

package/dist/src/db/conversation-history.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.repository.d.ts","sourceRoot":"","sources":["../../../src/db/conversation-history.repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAe5C,OAAO,KAAK,EACV,wBAAwB,EACxB,4BAA4B,EAC5B,cAAc,EACd,qBAAqB,EAEtB,MAAM,kCAAkC,CAAC;AAE1C,qBAAa,6BAA6B;IAW5B,OAAO,CAAC,EAAE;IATtB,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,oBAAoB,CAA+B;IAG3D,OAAO,CAAC,cAAc,CAAsB;IAG5C,OAAO,CAAC,WAAW,CAAyB;gBAExB,EAAE,EAAE,OAAO,CAAC,UAAU;IAI1C,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,mBAAmB;IAe3B,OAAO,CAAC,YAAY;IAUd,MAAM,CAAC,OAAO,EAAE,wBAAwB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB1D,UAAU,CACd,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAuBpC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAYvE,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBrD,iBAAiB,CACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAe3B,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA8B5D,mBAAmB,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;IASvD,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAehE"}

package/dist/src/db/conversation-history.repository.js

@@ -0,0 +1,184 @@
+import { CONVERSATION_HISTORY_TABLE, INDEXED_SESSIONS_TABLE, conversationHistorySchema, indexedSessionsSchema, } from "./conversation-history.schema.js";
+import { arrowVectorToArray, getOrCreateTable, createFtsMutex, createRerankerMutex, escapeLanceDbString, } from "./lancedb-utils.js";
+export class ConversationHistoryRepository {
+    db;
+    // Cached table handles — initialized once, retained for instance lifetime
+    tablePromise = null;
+    sessionsTablePromise = null;
+    // FTS index mutex — once created, the promise is never cleared (index persists in LanceDB)
+    ensureFtsIndex;
+    // Cached reranker — k=60 is constant, no need to recreate per search
+    getReranker = createRerankerMutex();
+    constructor(db) {
+        this.db = db;
+        this.ensureFtsIndex = createFtsMutex(() => this.getTable());
+    }
+    getTable() {
+        if (!this.tablePromise) {
+            this.tablePromise = getOrCreateTable(this.db, CONVERSATION_HISTORY_TABLE, conversationHistorySchema).catch((e) => {
+                this.tablePromise = null;
+                throw e;
+            });
+        }
+        return this.tablePromise;
+    }
+    getSessionsTable() {
+        if (!this.sessionsTablePromise) {
+            this.sessionsTablePromise = getOrCreateTable(this.db, INDEXED_SESSIONS_TABLE, indexedSessionsSchema).catch((e) => {
+                this.sessionsTablePromise = null;
+                throw e;
+            });
+        }
+        return this.sessionsTablePromise;
+    }
+    rowToEntry(row) {
+        return {
+            id: row.id,
+            content: row.content,
+            embedding: arrowVectorToArray(row.vector),
+            sessionId: row.session_id,
+            role: row.role,
+            messageIndex: row.message_index,
+            timestamp: new Date(row.timestamp),
+            metadata: JSON.parse(row.metadata),
+            createdAt: new Date(row.created_at),
+        };
+    }
+    rowToSessionSummary(row) {
+        return {
+            sessionId: row.session_id,
+            messageCount: row.message_count,
+            firstMessageAt: new Date(row.first_message_at),
+            lastMessageAt: new Date(row.last_message_at),
+            indexedAt: new Date(row.indexed_at),
+            // Use null check (not truthiness) — empty string is a valid value distinct from null
+            ...(row.project != null ? { project: row.project } : {}),
+            ...(row.git_branch != null ? { gitBranch: row.git_branch } : {}),
+        };
+    }
+    rowToSession(row) {
+        return {
+            ...this.rowToSessionSummary(row),
+            filePath: row.file_path,
+            fileSize: row.file_size,
+        };
+    }
+    // --- Conversation History Operations ---
+    async insert(entries) {
+        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, query, limit) {
+        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);
+            return {
+                ...entry,
+                rrfScore: row._relevance_score ?? 0,
+            };
+        });
+    }
+    async findBySessionId(sessionId) {
+        const table = await this.getTable();
+        const results = await table
+            .query()
+            .where(`session_id = '${escapeLanceDbString(sessionId)}'`)
+            .toArray();
+        return results.map((row) => this.rowToEntry(row));
+    }
+    async deleteBySessionId(sessionId) {
+        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) {
+        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]);
+    }
+    async upsertIndexedSession(session) {
+        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() {
+        const table = await this.getSessionsTable();
+        const results = await table.query().toArray();
+        return results.map((row) => this.rowToSessionSummary(row));
+    }
+    async deleteIndexedSession(sessionId) {
+        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;
+    }
+}
+//# sourceMappingURL=conversation-history.repository.js.map

package/dist/src/db/conversation-history.repository.js.map

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

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

@@ -0,0 +1,10 @@
+import { Schema } from "apache-arrow";
+export declare const CONVERSATION_HISTORY_TABLE = "conversation_history";
+/**
+ * Tracks which sessions have been indexed and their file sizes,
+ * enabling idempotent incremental indexing.
+ */
+export declare const INDEXED_SESSIONS_TABLE = "indexed_sessions";
+export declare const conversationHistorySchema: Schema<any>;
+export declare const indexedSessionsSchema: Schema<any>;
+//# sourceMappingURL=conversation-history.schema.d.ts.map

package/dist/src/db/conversation-history.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.schema.d.ts","sourceRoot":"","sources":["../../../src/db/conversation-history.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EAKP,MAAM,cAAc,CAAC;AAGtB,eAAO,MAAM,0BAA0B,yBAAyB,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD,eAAO,MAAM,yBAAyB,aAUpC,CAAC;AAEH,eAAO,MAAM,qBAAqB,aAUhC,CAAC"}

package/dist/src/db/conversation-history.schema.js

@@ -0,0 +1,31 @@
+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
+]);
+//# sourceMappingURL=conversation-history.schema.js.map

package/dist/src/db/conversation-history.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation-history.schema.js","sourceRoot":"","sources":["../../../src/db/conversation-history.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,KAAK,EACL,IAAI,EACJ,KAAK,EACL,OAAO,GACR,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,CAAC,MAAM,0BAA0B,GAAG,sBAAsB,CAAC;AAEjE;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;AAEzD,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,MAAM,CAAC;IAClD,IAAI,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC;IAClC,WAAW,EAAE;IACb,IAAI,KAAK,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC;IACvC,IAAI,KAAK,CAAC,YAAY,EAAE,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC;IAC1C,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,EAAE,uBAAuB;IAC7D,IAAI,KAAK,CAAC,eAAe,EAAE,IAAI,KAAK,EAAE,EAAE,KAAK,CAAC;IAC9C,cAAc,CAAC,WAAW,CAAC;IAC3B,IAAI,KAAK,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC,EAAE,cAAc;IACxD,cAAc,CAAC,YAAY,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,MAAM,CAAC;IAC9C,IAAI,KAAK,CAAC,YAAY,EAAE,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC;IAC1C,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC;IACzC,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,OAAO,EAAE,EAAE,KAAK,CAAC,EAAE,oDAAoD;IAClG,IAAI,KAAK,CAAC,eAAe,EAAE,IAAI,KAAK,EAAE,EAAE,KAAK,CAAC;IAC9C,cAAc,CAAC,kBAAkB,CAAC;IAClC,cAAc,CAAC,iBAAiB,CAAC;IACjC,cAAc,CAAC,YAAY,CAAC;IAC5B,IAAI,KAAK,CAAC,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW;IACnD,IAAI,KAAK,CAAC,YAAY,EAAE,IAAI,IAAI,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW;CACvD,CAAC,CAAC"}

package/dist/src/db/lancedb-utils.d.ts

@@ -0,0 +1,35 @@
+import * as lancedb from "@lancedb/lancedb";
+import { rerankers, type Table } from "@lancedb/lancedb";
+import type { Schema } from "apache-arrow";
+/**
+ * Escapes a string for use in LanceDB/DataFusion SQL WHERE clauses.
+ * Doubles single quotes to prevent SQL injection (standard SQL escaping).
+ */
+export declare function escapeLanceDbString(value: string): string;
+/**
+ * Converts LanceDB's Arrow Vector type to a plain number[].
+ * LanceDB returns an Arrow Vector object which is iterable but not an array.
+ */
+export declare function arrowVectorToArray(value: unknown): number[];
+/**
+ * Opens an existing table or creates it with the given schema.
+ * Does NOT cache — callers should cache the returned Table if desired.
+ */
+export declare function getOrCreateTable(db: lancedb.Connection, name: string, schema: Schema): Promise<Table>;
+/**
+ * Creates a mutex-guarded function that ensures an FTS index exists on a table's content column.
+ *
+ * Once the FTS index is confirmed/created, the promise is retained for the lifetime of the
+ * caller — the index persists in LanceDB, so re-checking is unnecessary. On error, the
+ * mutex resets so the next call can retry.
+ *
+ * The key design constraint: the promise must be captured synchronously (before any await)
+ * to prevent concurrent callers from racing past the guard.
+ */
+export declare function createFtsMutex(getTable: () => Promise<Table>): () => Promise<void>;
+/**
+ * Creates a promise-mutex for RRFReranker instantiation.
+ * Same pattern as createFtsMutex: create once, cache forever, reset on error.
+ */
+export declare function createRerankerMutex(k?: number): () => Promise<rerankers.RRFReranker>;
+//# sourceMappingURL=lancedb-utils.d.ts.map

package/dist/src/db/lancedb-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lancedb-utils.d.ts","sourceRoot":"","sources":["../../../src/db/lancedb-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAS,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,CAI3D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,OAAO,CAAC,UAAU,EACtB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC,CAMhB;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,GAC7B,MAAM,OAAO,CAAC,IAAI,CAAC,CA0BrB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,CAAC,GAAE,MAAW,GACb,MAAM,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAYtC"}

package/dist/src/db/lancedb-utils.js

@@ -0,0 +1,77 @@
+import { Index, rerankers } from "@lancedb/lancedb";
+/**
+ * Escapes a string for use in LanceDB/DataFusion SQL WHERE clauses.
+ * Doubles single quotes to prevent SQL injection (standard SQL escaping).
+ */
+export function escapeLanceDbString(value) {
+    return value.replace(/'/g, "''");
+}
+/**
+ * Converts LanceDB's Arrow Vector type to a plain number[].
+ * LanceDB returns an Arrow Vector object which is iterable but not an array.
+ */
+export function arrowVectorToArray(value) {
+    return Array.isArray(value)
+        ? value
+        : Array.from(value);
+}
+/**
+ * Opens an existing table or creates it with the given schema.
+ * Does NOT cache — callers should cache the returned Table if desired.
+ */
+export async function getOrCreateTable(db, name, schema) {
+    const names = await db.tableNames();
+    if (names.includes(name)) {
+        return await db.openTable(name);
+    }
+    return await db.createTable(name, [], { schema });
+}
+/**
+ * Creates a mutex-guarded function that ensures an FTS index exists on a table's content column.
+ *
+ * Once the FTS index is confirmed/created, the promise is retained for the lifetime of the
+ * caller — the index persists in LanceDB, so re-checking is unnecessary. On error, the
+ * mutex resets so the next call can retry.
+ *
+ * The key design constraint: the promise must be captured synchronously (before any await)
+ * to prevent concurrent callers from racing past the guard.
+ */
+export function createFtsMutex(getTable) {
+    let promise = null;
+    return () => {
+        if (promise)
+            return promise;
+        promise = (async () => {
+            const table = await getTable();
+            const indices = await table.listIndices();
+            const hasFtsIndex = indices.some((idx) => idx.columns.includes("content") && idx.indexType === "FTS");
+            if (!hasFtsIndex) {
+                await table.createIndex("content", {
+                    config: Index.fts(),
+                });
+                await table.waitForIndex(["content_idx"], 30);
+            }
+        })().catch((error) => {
+            promise = null;
+            throw error;
+        });
+        return promise;
+    };
+}
+/**
+ * Creates a promise-mutex for RRFReranker instantiation.
+ * Same pattern as createFtsMutex: create once, cache forever, reset on error.
+ */
+export function createRerankerMutex(k = 60) {
+    let promise = null;
+    return () => {
+        if (!promise) {
+            promise = rerankers.RRFReranker.create(k).catch((e) => {
+                promise = null;
+                throw e;
+            });
+        }
+        return promise;
+    };
+}
+//# sourceMappingURL=lancedb-utils.js.map

package/dist/src/db/lancedb-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lancedb-utils.js","sourceRoot":"","sources":["../../../src/db/lancedb-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAc,MAAM,kBAAkB,CAAC;AAGhE;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,KAAK;QACP,CAAC,CAAE,KAAK,CAAC,IAAI,CAAC,KAAyB,CAAc,CAAC;AAC1D,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,EAAsB,EACtB,IAAY,EACZ,MAAc;IAEd,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,UAAU,EAAE,CAAC;IACpC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,OAAO,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAAM,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAC5B,QAA8B;IAE9B,IAAI,OAAO,GAAyB,IAAI,CAAC;IAEzC,OAAO,GAAG,EAAE;QACV,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAE5B,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,IAAI,CAC9B,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,GAAG,CAAC,SAAS,KAAK,KAAK,CACpE,CAAC;YAEF,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,KAAK,CAAC,WAAW,CAAC,SAAS,EAAE;oBACjC,MAAM,EAAE,KAAK,CAAC,GAAG,EAAE;iBACpB,CAAC,CAAC;gBACH,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC;YAChD,CAAC;QACH,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACnB,OAAO,GAAG,IAAI,CAAC;YACf,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EAAE;IAEd,IAAI,OAAO,GAA0C,IAAI,CAAC;IAE1D,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;gBACpD,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,CAAC,CAAC;YACV,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/db/memory.repository.d.ts

@@ -2,8 +2,9 @@ import * as lancedb from "@lancedb/lancedb";
 import { type Memory, type HybridRow } from "../types/memory.js";
 export declare class MemoryRepository {
     private db;
-    private ftsIndexPromise;
     private migrationPromise;
+    private ensureFtsIndex;
+    private getReranker;
     constructor(db: lancedb.Connection);
     private getTable;
     /**
@@ -16,17 +17,6 @@ export declare class MemoryRepository {
      * This handles databases created before the hybrid memory system was introduced.
      */
     private migrateSchemaIfNeeded;
-    /**
-     * Ensures the FTS index exists on the content column.
-     * Uses a mutex pattern to prevent concurrent index creation.
-     * The key insight: we must capture the promise BEFORE any await.
-     */
-    private ensureFtsIndex;
-    /**
-     * Creates the FTS index if it doesn't already exist.
-     * Gets its own table reference to ensure consistent index state.
-     */
-    private createFtsIndexIfNeeded;
     /**
      * Converts a raw LanceDB row to a Memory object.
      */

package/dist/src/db/memory.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.repository.d.ts","sourceRoot":"","sources":["../../../src/db/memory.repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAG5C,OAAO,EACL,KAAK,MAAM,EACX,KAAK,SAAS,EAEf,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,gBAAgB;IAQf,OAAO,CAAC,EAAE;IALtB,OAAO,CAAC,eAAe,CAA8B;IAGrD,OAAO,CAAC,gBAAgB,CAA8B;gBAElC,EAAE,EAAE,OAAO,CAAC,UAAU;YAE5B,QAAQ;IAWtB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAavB;;;OAGG;YACW,qBAAqB;IAqBnC;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAiBtB;;;OAGG;YACW,sBAAsB;IAgBpC;;OAEG;IACH,OAAO,CAAC,WAAW;IAwBb,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBrC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW5C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB/C;;;;;;;;OAQG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CA2B1F"}
+{"version":3,"file":"memory.repository.d.ts","sourceRoot":"","sources":["../../../src/db/memory.repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAI5C,OAAO,EACL,KAAK,MAAM,EACX,KAAK,SAAS,EAEf,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,gBAAgB;IAUf,OAAO,CAAC,EAAE;IARtB,OAAO,CAAC,gBAAgB,CAA8B;IAGtD,OAAO,CAAC,cAAc,CAAsB;IAG5C,OAAO,CAAC,WAAW,CAAyB;gBAExB,EAAE,EAAE,OAAO,CAAC,UAAU;YAI5B,QAAQ;IAWtB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAavB;;;OAGG;YACW,qBAAqB;IAqBnC;;OAEG;IACH,OAAO,CAAC,WAAW;IAiBb,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBrC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAW5C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB/C;;;;;;;;OAQG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;CAsB1F"}