@aeriondyseti/vector-memory-mcp 2.1.1 → 2.2.0-dev.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aeriondyseti/vector-memory-mcp",
-  "version": "2.1.1",
+  "version": "2.2.0-dev.0",
   "description": "A zero-configuration RAG memory server for MCP clients",
   "type": "module",
   "main": "src/index.ts",

package/src/http/server.ts

@@ -189,7 +189,8 @@ export function createHttpApp(memoryService: MemoryService, config: Config): Hon
   // Get latest waypoint
   app.get("/waypoint", async (c) => {
     try {
-      const waypoint = await memoryService.getLatestWaypoint();
+      const project = c.req.query("project");
+      const waypoint = await memoryService.getLatestWaypoint(project);
 
       if (!waypoint) {
         return c.json({ error: "No waypoint found" }, 404);

package/src/mcp/handlers.ts

@@ -38,6 +38,10 @@ function errorText(e: unknown): string {
   return e instanceof Error ? e.message : String(e);
 }
 
+function errorResult(text: string): CallToolResult {
+  return { isError: true, content: [{ type: "text", text }] };
+}
+
 function parseDate(value: unknown, fieldName: string): Date | undefined {
   if (value === undefined) return undefined;
   const date = new Date(value as string);
@@ -59,7 +63,7 @@ export async function handleStoreMemories(
   try {
     memories = asArray(args?.memories, "memories");
   } catch (e) {
-    return { isError: true, content: [{ type: "text", text: errorText(e) }] };
+    return errorResult(errorText(e));
   }
 
   const ids: string[] = [];
@@ -93,7 +97,7 @@ export async function handleDeleteMemories(
   try {
     ids = asArray(args?.ids, "ids");
   } catch (e) {
-    return { isError: true, content: [{ type: "text", text: errorText(e) }] };
+    return errorResult(errorText(e));
   }
   const results: string[] = [];
 
@@ -128,7 +132,7 @@ export async function handleUpdateMemories(
   try {
     updates = asArray(args?.updates, "updates");
   } catch (e) {
-    return { isError: true, content: [{ type: "text", text: errorText(e) }] };
+    return errorResult(errorText(e));
   }
 
   const results: string[] = [];
@@ -168,10 +172,11 @@ export async function handleSearchMemories(
 ): Promise<CallToolResult> {
   const query = args?.query;
   if (typeof query !== "string" || query.trim() === "") {
-    return { isError: true, content: [{ type: "text", text: "query is required and must be a non-empty string" }] };
+    return errorResult("query is required and must be a non-empty string");
   }
   const intent = (args?.intent as SearchIntent) ?? "fact_check";
   const limit = (args?.limit as number) ?? 10;
+  const offset = (args?.offset as number) ?? 0;
   const includeDeleted = (args?.include_deleted as boolean) ?? false;
   const historyOnly = (args?.history_only as boolean) ?? false;
   // history_only implies include_history
@@ -181,13 +186,14 @@ export async function handleSearchMemories(
   try {
     historyFilters = parseHistoryFilters(args);
   } catch (e) {
-    return { isError: true, content: [{ type: "text", text: errorText(e) }] };
+    return errorResult(errorText(e));
   }
 
   const results = await service.search(query, intent, limit, includeDeleted, {
     includeHistory,
     historyOnly,
     historyFilters,
+    offset,
   });
 
   if (results.length === 0) {
@@ -243,7 +249,7 @@ export async function handleGetMemories(
   try {
     ids = asArray(args?.ids, "ids");
   } catch (e) {
-    return { isError: true, content: [{ type: "text", text: errorText(e) }] };
+    return errorResult(errorText(e));
   }
 
   const memories = await service.getMultiple(ids);
@@ -267,10 +273,7 @@ export async function handleReportMemoryUsefulness(
   const memory = await service.vote(memoryId, useful ? 1 : -1);
 
   if (!memory) {
-    return {
-      content: [{ type: "text", text: `Memory ${memoryId} not found` }],
-      isError: true,
-    };
+    return errorResult(`Memory ${memoryId} not found`);
   }
 
   return {
@@ -305,10 +308,11 @@ export async function handleSetWaypoint(
 }
 
 export async function handleGetWaypoint(
-  _args: Record<string, unknown> | undefined,
+  args: Record<string, unknown> | undefined,
   service: MemoryService
 ): Promise<CallToolResult> {
-  const waypoint = await service.getLatestWaypoint();
+  const project = args?.project as string | undefined;
+  const waypoint = await service.getLatestWaypoint(project);
 
   if (!waypoint) {
     return {
@@ -350,15 +354,9 @@ function requireConversationService(
   const conversationService = service.getConversationService();
   if (!conversationService) {
     return {
-      error: {
-        content: [
-          {
-            type: "text",
-            text: "Conversation history indexing is not enabled. Enable it with --enable-history.",
-          },
-        ],
-        isError: true,
-      },
+      error: errorResult(
+        "Conversation history indexing is not enabled. Enable it with --enable-history."
+      ),
     };
   }
   return { service: conversationService };
@@ -376,7 +374,7 @@ export async function handleIndexConversations(
   const sinceStr = args?.since as string | undefined;
   const since = sinceStr ? new Date(sinceStr) : undefined;
   if (since && isNaN(since.getTime())) {
-    return { isError: true, content: [{ type: "text", text: "Invalid 'since' date format" }] };
+    return errorResult("Invalid 'since' date format");
   }
 
   const result = await conversationService.indexConversations(path, since);
@@ -444,18 +442,12 @@ export async function handleReindexSession(
 
   const sessionId = args?.session_id as string | undefined;
   if (!sessionId) {
-    return {
-      content: [{ type: "text", text: "session_id is required" }],
-      isError: true,
-    };
+    return errorResult("session_id is required");
   }
   const result = await conversationService.reindexSession(sessionId);
 
   if (!result.success) {
-    return {
-      content: [{ type: "text", text: `Reindex failed: ${result.error}` }],
-      isError: true,
-    };
+    return errorResult(`Reindex failed: ${result.error}`);
   }
 
   return {
@@ -497,9 +489,6 @@ export async function handleToolCall(
     case "reindex_session":
       return handleReindexSession(args, service);
     default:
-      return {
-        content: [{ type: "text", text: `Unknown tool: ${name}` }],
-        isError: true,
-      };
+      return errorResult(`Unknown tool: ${name}`);
   }
 }

package/src/mcp/tools.ts

@@ -162,6 +162,11 @@ When in doubt, search. Missing context is costlier than an extra query.`,
         description: "Maximum results to return (default: 10).",
         default: 10,
       },
+      offset: {
+        type: "integer",
+        description: "Number of results to skip for pagination (default: 0).",
+        default: 0,
+      },
       include_deleted: {
         type: "boolean",
         description: "Include soft-deleted memories in results (default: false). Useful for recovering prior information.",
@@ -297,7 +302,13 @@ export const getWaypointTool: Tool = {
     "Load the current project waypoint snapshot. Call at conversation start or when resuming a project.",
   inputSchema: {
     type: "object",
-    properties: {},
+    properties: {
+      project: {
+        type: "string",
+        description:
+          "Project name to retrieve waypoint for. If omitted, retrieves the default (legacy) waypoint.",
+      },
+    },
   },
 };
 

package/src/services/memory.service.ts

@@ -1,4 +1,4 @@
-import { randomUUID } from "crypto";
+import { randomUUID, createHash } from "crypto";
 import type { Memory, SearchIntent, IntentProfile, HybridRow } from "../types/memory.js";
 import { isDeleted } from "../types/memory.js";
 import type { SearchResult, SearchOptions } from "../types/conversation.js";
@@ -185,6 +185,7 @@ export class MemoryService {
     const queryEmbedding = await this.embeddings.embed(query);
     const profile = INTENT_PROFILES[intent];
     const now = new Date();
+    const offset = Math.min(options?.offset ?? 0, 500);
 
     const hasConversationService = this.conversationService !== null;
     const historyOnly = (options?.historyOnly ?? false) && hasConversationService;
@@ -195,11 +196,14 @@ export class MemoryService {
       this.conversationService?.config.historyWeight ??
       0.75;
 
+    // Widen the candidate pool to account for offset
+    const effectiveLimit = offset + limit;
+
     // Run memory + history queries in parallel
     const memoryPromise =
       !historyOnly
         ? this.repository
-            .findHybrid(queryEmbedding, query, limit * 5)
+            .findHybrid(queryEmbedding, query, effectiveLimit * 5)
             .then((candidates) =>
               candidates
                 .filter((m) => includeDeleted || !isDeleted(m))
@@ -225,7 +229,7 @@ export class MemoryService {
             .searchHistory(
               query,
               queryEmbedding,
-              historyOnly ? limit * 5 : limit * 3,
+              historyOnly ? effectiveLimit * 5 : effectiveLimit * 3,
               options?.historyFilters
             )
             .then((historyRows) =>
@@ -255,7 +259,7 @@ export class MemoryService {
     const merged = [...memoryResults, ...historyResults];
     merged.sort((a, b) => b.score - a.score);
 
-    return merged.slice(0, limit);
+    return merged.slice(offset, offset + limit);
   }
 
   async trackAccess(ids: string[]): Promise<void> {
@@ -278,6 +282,19 @@ export class MemoryService {
   private static readonly UUID_ZERO =
     "00000000-0000-0000-0000-000000000000";
 
+  private static waypointId(project?: string): string {
+    if (!project?.length) return MemoryService.UUID_ZERO;
+    const hex = createHash("sha256").update(`waypoint:${project}`).digest("hex");
+    // Format as UUID: 8-4-4-4-12
+    return [
+      hex.slice(0, 8),
+      hex.slice(8, 12),
+      hex.slice(12, 16),
+      hex.slice(16, 20),
+      hex.slice(20, 32),
+    ].join("-");
+  }
+
   async setWaypoint(args: {
     project: string;
     branch?: string;
@@ -336,7 +353,7 @@ ${list(args.memory_ids)}`;
     };
 
     const memory: Memory = {
-      id: MemoryService.UUID_ZERO,
+      id: MemoryService.waypointId(args.project),
       content,
       embedding: new Array(this.embeddings.dimension).fill(0),
       metadata,
@@ -352,7 +369,7 @@ ${list(args.memory_ids)}`;
     return memory;
   }
 
-  async getLatestWaypoint(): Promise<Memory | null> {
-    return await this.get(MemoryService.UUID_ZERO);
+  async getLatestWaypoint(project?: string): Promise<Memory | null> {
+    return await this.get(MemoryService.waypointId(project));
   }
 }

package/src/types/conversation.ts

@@ -118,4 +118,5 @@ export interface SearchOptions {
   historyOnly?: boolean;
   historyWeight?: number;
   historyFilters?: HistoryFilters;
+  offset?: number;
 }