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

package/dist/src/services/parsers/claude-code.parser.js

@@ -0,0 +1,191 @@
+import { readFile, readdir, stat } from "fs/promises";
+import { basename, dirname, join } from "path";
+// UUID pattern for session IDs
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Extract text content from an assistant message's content array */
+function extractAssistantText(content) {
+    return content
+        .filter((block) => block.type === "text" && block.text)
+        .map((block) => block.text)
+        .join("\n");
+}
+/**
+ * Extract project name from path-encoded directory name.
+ * Claude Code encodes paths by replacing `/` with `-`, e.g. `/home/user/project` → `-home-user-project`.
+ * This is a lossy encoding: directory names containing literal dashes (e.g. `my-project`)
+ * cannot be distinguished from path separators, so `my-project` decodes as `my/project`.
+ * This is a known limitation of Claude Code's encoding scheme.
+ */
+function extractProjectFromDir(dirName) {
+    return dirName.startsWith("-")
+        ? dirName.slice(1).replace(/-/g, "/")
+        : dirName;
+}
+export class ClaudeCodeSessionParser {
+    async parse(filePath, indexSubagents = false) {
+        const fileContent = await readFile(filePath, "utf-8");
+        const lines = fileContent.split("\n").filter((line) => line.trim());
+        const messages = [];
+        let messageIndex = 0;
+        // Derive session ID and project from file path
+        const fileName = basename(filePath, ".jsonl");
+        const parentDir = basename(dirname(filePath));
+        // Check if this is inside a subagents directory
+        const isSubagentFile = filePath.includes("/subagents/");
+        // For subagent files, project dir is 3 levels up: <project>/<session>/subagents/<file>
+        // For main files, project dir is direct parent
+        const projectDir = isSubagentFile
+            ? basename(dirname(dirname(dirname(filePath))))
+            : parentDir;
+        const project = extractProjectFromDir(projectDir);
+        for (const line of lines) {
+            let entry;
+            try {
+                entry = JSON.parse(line);
+            }
+            catch {
+                // Skip malformed lines
+                continue;
+            }
+            const type = entry.type;
+            // Skip non-message entries
+            if (type === "progress" || type === "file-history-snapshot") {
+                continue;
+            }
+            // Skip subagent messages unless configured to include them
+            if (!indexSubagents && (entry.isSidechain === true || isSubagentFile)) {
+                continue;
+            }
+            if (type !== "user" && type !== "assistant") {
+                continue;
+            }
+            const message = entry.message;
+            if (!message)
+                continue;
+            const role = message.role;
+            if (role !== "user" && role !== "assistant")
+                continue;
+            let content = null;
+            if (role === "user") {
+                const msgContent = message.content;
+                if (typeof msgContent === "string") {
+                    content = msgContent;
+                }
+                else if (Array.isArray(msgContent)) {
+                    // Array content in user messages = tool_result entries, skip
+                    continue;
+                }
+            }
+            else if (role === "assistant") {
+                const msgContent = message.content;
+                if (Array.isArray(msgContent)) {
+                    content = extractAssistantText(msgContent);
+                }
+            }
+            // Skip empty content
+            if (!content || content.trim().length === 0) {
+                continue;
+            }
+            const sessionId = entry.sessionId ?? fileName;
+            messages.push({
+                uuid: entry.uuid ?? `${sessionId}-${messageIndex}`,
+                role: role,
+                content: content.trim(),
+                timestamp: entry.timestamp
+                    ? new Date(entry.timestamp)
+                    : new Date(),
+                messageIndex,
+                sessionId,
+                project,
+                gitBranch: entry.gitBranch,
+                isSubagent: entry.isSidechain ?? isSubagentFile,
+                agentId: entry.agentId,
+            });
+            messageIndex++;
+        }
+        return messages;
+    }
+    async findSessionFiles(dirPath, since, indexSubagents = false) {
+        const files = [];
+        let dirents;
+        try {
+            dirents = await readdir(dirPath, { withFileTypes: true });
+        }
+        catch {
+            return files;
+        }
+        for (const dirent of dirents) {
+            const entryPath = join(dirPath, dirent.name);
+            if (dirent.isDirectory()) {
+                if (dirent.name === "subagents") {
+                    if (indexSubagents) {
+                        const subFiles = await this.findSubagentFiles(entryPath, since, basename(dirname(dirname(entryPath))));
+                        files.push(...subFiles);
+                    }
+                    continue;
+                }
+                const subFiles = await this.findSessionFiles(entryPath, since, indexSubagents);
+                files.push(...subFiles);
+            }
+            else if (dirent.name.endsWith(".jsonl")) {
+                const sessionId = basename(dirent.name, ".jsonl");
+                if (!UUID_PATTERN.test(sessionId))
+                    continue;
+                let entryStat;
+                try {
+                    entryStat = await stat(entryPath);
+                }
+                catch {
+                    continue;
+                }
+                const lastModified = entryStat.mtime;
+                if (since && lastModified <= since)
+                    continue;
+                const projectDir = basename(dirPath);
+                const project = extractProjectFromDir(projectDir);
+                files.push({
+                    filePath: entryPath,
+                    sessionId,
+                    project,
+                    lastModified,
+                });
+            }
+        }
+        return files;
+    }
+    async findSubagentFiles(subagentsDir, since, projectDir) {
+        const files = [];
+        let entries;
+        try {
+            entries = await readdir(subagentsDir);
+        }
+        catch {
+            return files;
+        }
+        for (const entry of entries) {
+            if (!entry.endsWith(".jsonl"))
+                continue;
+            const entryPath = join(subagentsDir, entry);
+            let entryStat;
+            try {
+                entryStat = await stat(entryPath);
+            }
+            catch {
+                continue;
+            }
+            const lastModified = entryStat.mtime;
+            if (since && lastModified <= since)
+                continue;
+            const sessionId = basename(entry, ".jsonl");
+            const project = extractProjectFromDir(projectDir);
+            files.push({
+                filePath: entryPath,
+                sessionId,
+                project,
+                lastModified,
+            });
+        }
+        return files;
+    }
+}
+//# sourceMappingURL=claude-code.parser.js.map

package/dist/src/services/parsers/claude-code.parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.parser.js","sourceRoot":"","sources":["../../../../src/services/parsers/claude-code.parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI/C,+BAA+B;AAC/B,MAAM,YAAY,GAChB,iEAAiE,CAAC;AAEpE,qEAAqE;AACrE,SAAS,oBAAoB,CAC3B,OAA+C;IAE/C,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC;SACtD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAK,CAAC;SAC3B,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,qBAAqB,CAAC,OAAe;IAC5C,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAC5B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;QACrC,CAAC,CAAC,OAAO,CAAC;AACd,CAAC;AAED,MAAM,OAAO,uBAAuB;IAClC,KAAK,CAAC,KAAK,CACT,QAAgB,EAChB,iBAA0B,KAAK;QAE/B,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAEpE,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,+CAA+C;QAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC9C,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC9C,gDAAgD;QAChD,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;QAExD,uFAAuF;QACvF,+CAA+C;QAC/C,MAAM,UAAU,GAAG,cAAc;YAC/B,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC/C,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,OAAO,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAElD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,KAA8B,CAAC;YACnC,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;gBACvB,SAAS;YACX,CAAC;YAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAc,CAAC;YAElC,2BAA2B;YAC3B,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,uBAAuB,EAAE,CAAC;gBAC5D,SAAS;YACX,CAAC;YAED,2DAA2D;YAC3D,IAAI,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,WAAW,KAAK,IAAI,IAAI,cAAc,CAAC,EAAE,CAAC;gBACtE,SAAS;YACX,CAAC;YAED,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC5C,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,OAA8C,CAAC;YACrE,IAAI,CAAC,OAAO;gBAAE,SAAS;YAEvB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAc,CAAC;YACpC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,WAAW;gBAAE,SAAS;YAEtD,IAAI,OAAO,GAAkB,IAAI,CAAC;YAElC,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;gBACpB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;gBACnC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;oBACnC,OAAO,GAAG,UAAU,CAAC;gBACvB,CAAC;qBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;oBACrC,6DAA6D;oBAC7D,SAAS;gBACX,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;gBAChC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;gBACnC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC9B,OAAO,GAAG,oBAAoB,CAC5B,UAAoD,CACrD,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,qBAAqB;YACrB,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC5C,SAAS;YACX,CAAC;YAED,MAAM,SAAS,GACZ,KAAK,CAAC,SAAoB,IAAI,QAAQ,CAAC;YAE1C,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAG,KAAK,CAAC,IAAe,IAAI,GAAG,SAAS,IAAI,YAAY,EAAE;gBAC9D,IAAI,EAAE,IAA4B;gBAClC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;gBACvB,SAAS,EAAE,KAAK,CAAC,SAAS;oBACxB,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,SAAmB,CAAC;oBACrC,CAAC,CAAC,IAAI,IAAI,EAAE;gBACd,YAAY;gBACZ,SAAS;gBACT,OAAO;gBACP,SAAS,EAAE,KAAK,CAAC,SAA+B;gBAChD,UAAU,EAAG,KAAK,CAAC,WAAuB,IAAI,cAAc;gBAC5D,OAAO,EAAE,KAAK,CAAC,OAA6B;aAC7C,CAAC,CAAC;YAEH,YAAY,EAAE,CAAC;QACjB,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,OAAe,EACf,KAAY,EACZ,iBAA0B,KAAK;QAE/B,MAAM,KAAK,GAAsB,EAAE,CAAC;QAEpC,IAAI,OAA8B,CAAC;QACnC,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAE7C,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;gBACzB,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBAChC,IAAI,cAAc,EAAE,CAAC;wBACnB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAC3C,SAAS,EACT,KAAK,EACL,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CACtC,CAAC;wBACF,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;oBAC1B,CAAC;oBACD,SAAS;gBACX,CAAC;gBAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAC1C,SAAS,EACT,KAAK,EACL,cAAc,CACf,CAAC;gBACF,KAAK,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;YAC1B,CAAC;iBAAM,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1C,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBAClD,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC;oBAAE,SAAS;gBAE5C,IAAI,SAAS,CAAC;gBACd,IAAI,CAAC;oBACH,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;gBACpC,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS;gBACX,CAAC;gBAED,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC;gBACrC,IAAI,KAAK,IAAI,YAAY,IAAI,KAAK;oBAAE,SAAS;gBAE7C,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACrC,MAAM,OAAO,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;gBAElD,KAAK,CAAC,IAAI,CAAC;oBACT,QAAQ,EAAE,SAAS;oBACnB,SAAS;oBACT,OAAO;oBACP,YAAY;iBACb,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,YAAoB,EACpB,KAAuB,EACvB,UAAkB;QAElB,MAAM,KAAK,GAAsB,EAAE,CAAC;QACpC,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAAE,SAAS;YAExC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAC5C,IAAI,SAAS,CAAC;YACd,IAAI,CAAC;gBACH,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC;YACrC,IAAI,KAAK,IAAI,YAAY,IAAI,KAAK;gBAAE,SAAS;YAE7C,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;YAElD,KAAK,CAAC,IAAI,CAAC;gBACT,QAAQ,EAAE,SAAS;gBACnB,SAAS;gBACT,OAAO;gBACP,YAAY;aACb,CAAC,CAAC;QACL,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/src/services/parsers/types.d.ts

@@ -0,0 +1,9 @@
+import type { ParsedMessage, SessionFileInfo } from "../../types/conversation.js";
+/** Interface for parsing session log files into structured messages */
+export interface SessionLogParser {
+    /** Parse a session log file into ordered messages */
+    parse(filePath: string, indexSubagents?: boolean): Promise<ParsedMessage[]>;
+    /** Discover session log files in a directory */
+    findSessionFiles(dirPath: string, since?: Date, indexSubagents?: boolean): Promise<SessionFileInfo[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/services/parsers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/parsers/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAElF,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC/B,qDAAqD;IACrD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAE5E,gDAAgD;IAChD,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,IAAI,EACZ,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;CAC/B"}

package/dist/src/services/parsers/types.js

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

package/dist/src/services/parsers/types.js.map

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

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

@@ -0,0 +1,99 @@
+/** A single parsed message from a session log */
+export interface ParsedMessage {
+    uuid: string;
+    role: "user" | "assistant";
+    content: string;
+    timestamp: Date;
+    messageIndex: number;
+    sessionId: string;
+    project: string;
+    gitBranch?: string;
+    isSubagent: boolean;
+    agentId?: string;
+}
+/** Metadata stored per conversation chunk in the database */
+export interface ConversationChunkMetadata {
+    session_id: string;
+    timestamp: string;
+    role: string;
+    message_index_start: number;
+    message_index_end: number;
+    project: string;
+    git_branch?: string;
+    is_subagent: boolean;
+    agent_id?: string;
+}
+/** A chunk of conversation ready for indexing */
+export interface ConversationChunk {
+    id: string;
+    content: string;
+    sessionId: string;
+    timestamp: Date;
+    endTimestamp: Date;
+    role: string;
+    messageIndexStart: number;
+    messageIndexEnd: number;
+    project: string;
+    metadata: ConversationChunkMetadata;
+}
+/** Tracking record for an indexed session */
+export interface IndexedSession {
+    sessionId: string;
+    filePath: string;
+    project: string;
+    lastModified: number;
+    chunkCount: number;
+    messageCount: number;
+    indexedAt: Date;
+    firstMessageAt: Date;
+    lastMessageAt: Date;
+}
+/** Raw row from conversation_history table with RRF score */
+export interface ConversationHybridRow {
+    id: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    rrfScore: number;
+}
+/** Unified search result with source provenance */
+export interface SearchResult {
+    id: string;
+    content: string;
+    metadata: Record<string, unknown>;
+    createdAt: Date;
+    updatedAt: Date;
+    source: "memory" | "conversation_history";
+    score: number;
+    supersededBy?: string | null;
+    usefulness?: number;
+    accessCount?: number;
+    lastAccessed?: Date | null;
+    sessionId?: string;
+    role?: string;
+    messageIndexStart?: number;
+    messageIndexEnd?: number;
+}
+/** Session file info returned by the parser's file discovery */
+export interface SessionFileInfo {
+    filePath: string;
+    sessionId: string;
+    project: string;
+    lastModified: Date;
+}
+/** Search filter options for conversation history */
+export interface HistoryFilters {
+    sessionId?: string;
+    role?: string;
+    project?: string;
+    after?: Date;
+    before?: Date;
+}
+/** Options for the integrated search across both sources */
+export interface SearchOptions {
+    includeHistory?: boolean;
+    historyOnly?: boolean;
+    historyWeight?: number;
+    historyFilters?: HistoryFilters;
+}
+//# sourceMappingURL=conversation.d.ts.map

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

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

package/dist/src/types/conversation.js

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

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

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

package/hooks/session-start.ts

@@ -2,10 +2,10 @@
 /**
  * SessionStart hook for Claude Code
  *
- * Fetches config from the running vector-memory server's /health endpoint,
- * then retrieves and outputs the latest checkpoint.
+ * 1. Triggers incremental conversation history indexing (if enabled)
+ * 2. Loads and outputs the latest checkpoint with referenced memories
  *
- * Requires the server to be running with HTTP enabled.
+ * Requires the vector-memory-mcp server to be running with HTTP enabled.
  *
  * Usage in ~/.claude/settings.json:
  * {
@@ -20,13 +20,8 @@
  * }
  */
 
-import { existsSync } from "fs";
-import { connectToDatabase } from "../src/db/connection.js";
-import { MemoryRepository } from "../src/db/memory.repository.js";
-import { EmbeddingsService } from "../src/services/embeddings.service.js";
-import { MemoryService } from "../src/services/memory.service.js";
-
-const VECTOR_MEMORY_URL = process.env.VECTOR_MEMORY_URL ?? "http://127.0.0.1:3271";
+const VECTOR_MEMORY_URL =
+  process.env.VECTOR_MEMORY_URL ?? "http://127.0.0.1:3271";
 
 interface HealthResponse {
   status: string;
@@ -34,11 +29,19 @@ interface HealthResponse {
     dbPath: string;
     embeddingModel: string;
     embeddingDimension: number;
+    historyEnabled: boolean;
   };
 }
 
+interface CheckpointResponse {
+  content: string;
+  metadata: Record<string, unknown>;
+  referencedMemories: Array<{ id: string; content: string }>;
+  updatedAt: string;
+}
+
 async function main() {
-  // Get config from running server
+  // Step 1: Check server is running and get config
   let health: HealthResponse;
   try {
     const response = await fetch(`${VECTOR_MEMORY_URL}/health`);
@@ -54,47 +57,62 @@ async function main() {
     throw error;
   }
 
-  const { dbPath, embeddingModel, embeddingDimension } = health.config;
-
-  // Check if DB exists
-  if (!existsSync(dbPath)) {
-    console.log("Vector memory database not found. Starting fresh session.");
-    return;
+  // Step 2: Trigger conversation history indexing (if enabled)
+  if (health.config.historyEnabled) {
+    try {
+      const indexResponse = await fetch(
+        `${VECTOR_MEMORY_URL}/index-conversations`,
+        { method: "POST", headers: { "Content-Type": "application/json" }, body: "{}" }
+      );
+      if (indexResponse.ok) {
+        const result = await indexResponse.json();
+        if (result.indexed > 0 || result.errors?.length > 0) {
+          console.error(
+            `[vector-memory] Indexed ${result.indexed} sessions, skipped ${result.skipped}` +
+              (result.errors?.length > 0
+                ? `, ${result.errors.length} errors`
+                : "")
+          );
+        }
+      }
+    } catch {
+      // Non-fatal — indexing failure shouldn't block session start
+      console.error("[vector-memory] Conversation indexing failed, continuing.");
+    }
   }
 
-  const db = await connectToDatabase(dbPath);
-  const repository = new MemoryRepository(db);
-  const embeddings = new EmbeddingsService(embeddingModel, embeddingDimension);
-  const service = new MemoryService(repository, embeddings);
-
-  const checkpoint = await service.getLatestCheckpoint();
-
-  if (!checkpoint) {
-    console.log("No checkpoint found. Starting fresh session.");
+  // Step 3: Load and output checkpoint
+  let checkpoint: CheckpointResponse;
+  try {
+    const response = await fetch(`${VECTOR_MEMORY_URL}/checkpoint`);
+    if (response.status === 404) {
+      console.log("No checkpoint found. Starting fresh session.");
+      return;
+    }
+    if (!response.ok) {
+      throw new Error(`Checkpoint endpoint returned ${response.status}`);
+    }
+    checkpoint = await response.json();
+  } catch (error) {
+    const msg = error instanceof Error ? error.message : String(error);
+    console.error(`[vector-memory] Failed to load checkpoint: ${msg}`);
     return;
   }
 
-  // Fetch referenced memories if any
-  const memoryIds = (checkpoint.metadata.memory_ids as string[] | undefined) ?? [];
-  let memoriesSection = "";
+  // Format output: checkpoint content + referenced memories
+  let output = checkpoint.content;
 
-  if (memoryIds.length > 0) {
-    const memories: string[] = [];
-    for (const id of memoryIds) {
-      const memory = await service.get(id);
-      if (memory) {
-        memories.push(`### Memory: ${id}\n${memory.content}`);
-      }
-    }
-    if (memories.length > 0) {
-      memoriesSection = `\n\n## Referenced Memories\n\n${memories.join("\n\n")}`;
-    }
+  if (checkpoint.referencedMemories.length > 0) {
+    const memoriesSection = checkpoint.referencedMemories
+      .map((m) => `### Memory: ${m.id}\n${m.content}`)
+      .join("\n\n");
+    output += `\n\n## Referenced Memories\n\n${memoriesSection}`;
   }
 
-  console.log(checkpoint.content + memoriesSection);
+  console.log(output);
 }
 
 main().catch((err) => {
-  console.error("Error loading checkpoint:", err.message);
+  console.error("Error in session-start hook:", err.message);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeriondyseti/vector-memory-mcp",
-  "version": "1.1.0-dev.2",
+  "version": "1.1.0-dev.3",
   "description": "A zero-configuration RAG memory server for MCP clients",
   "type": "module",
   "main": "dist/src/index.js",

package/src/config/index.ts

@@ -1,4 +1,5 @@
 import arg from "arg";
+import { homedir } from "os";
 import { isAbsolute, join } from "path";
 import packageJson from "../../package.json" with { type: "json" };
 
@@ -6,6 +7,15 @@ export const VERSION = packageJson.version;
 
 export type TransportMode = "stdio" | "http" | "both";
 
+export interface ConversationHistoryConfig {
+  enabled: boolean;
+  sessionLogPath: string | null;
+  historyWeight: number;
+  chunkOverlap: number;
+  maxChunkMessages: number;
+  indexSubagents: boolean;
+}
+
 export interface Config {
   dbPath: string;
   embeddingModel: string;
@@ -14,11 +24,7 @@ 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
-  };
+  conversationHistory: ConversationHistoryConfig;
 }
 
 export interface ConfigOverrides {
@@ -26,11 +32,9 @@ export interface ConfigOverrides {
   httpPort?: number;
   enableHttp?: boolean;
   transportMode?: TransportMode;
-  conversationHistory?: {
-    enabled?: boolean;
-    sessionPath?: string;
-    historyWeight?: number;
-  };
+  enableHistory?: boolean;
+  historyPath?: string;
+  historyWeight?: number;
 }
 
 // Defaults - always use repo-local .vector-memory folder
@@ -58,9 +62,12 @@ export function loadConfig(overrides: ConfigOverrides = {}): Config {
     enableHttp,
     transportMode,
     conversationHistory: {
-      enabled: overrides.conversationHistory?.enabled ?? false,
-      sessionPath: overrides.conversationHistory?.sessionPath ?? null,
-      historyWeight: overrides.conversationHistory?.historyWeight ?? 0.5,
+      enabled: overrides.enableHistory ?? false,
+      sessionLogPath: overrides.historyPath ?? null,
+      historyWeight: overrides.historyWeight ?? 0.75,
+      chunkOverlap: 1,
+      maxChunkMessages: 10,
+      indexSubagents: false,
     },
   };
 }
@@ -74,8 +81,9 @@ export function parseCliArgs(argv: string[]): ConfigOverrides {
       "--db-file": String,
       "--port": Number,
       "--no-http": Boolean,
-      "--conversation-history": Boolean,
-      "--session-path": String,
+      "--enable-history": Boolean,
+      "--history-path": String,
+      "--history-weight": Number,
 
       // Aliases
       "-d": "--db-file",
@@ -88,14 +96,24 @@ 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,
+    enableHistory: args["--enable-history"] ?? undefined,
+    historyPath: args["--history-path"],
+    historyWeight: args["--history-weight"],
   };
 }
 
+/**
+ * Resolve the session log path for conversation history indexing.
+ * Returns the configured path, or auto-detects Claude Code's session directory.
+ */
+export function resolveSessionLogPath(config: ConversationHistoryConfig): string {
+  if (config.sessionLogPath) {
+    return resolvePath(config.sessionLogPath);
+  }
+  // Auto-detect Claude Code session log directory
+  const claudeProjectsDir = join(homedir(), ".claude", "projects");
+  return claudeProjectsDir;
+}
+
 // Default config for imports that don't use CLI args
 export const config = loadConfig();