@aeriondyseti/vector-memory-mcp 2.4.4-dev.1 → 2.5.0-dev.1

package/server/transports/mcp/tools.ts

@@ -47,6 +47,12 @@ For long content (>1000 chars), provide embedding_text with a searchable summary
               description: "Optional key-value metadata.",
               additionalProperties: true,
             },
+            project: {
+              type: "string",
+              description:
+                "Project to tag this memory with (canonical absolute path). " +
+                "Defaults to the current project — only pass this to file a memory under a different project.",
+            },
           },
           required: ["content"],
         },
@@ -139,7 +145,9 @@ INTENTS:
 - associative: Brainstorm, find connections (high relevance + mild jitter)
 - explore: Stuck/creative mode (balanced + high jitter)
 
-When in doubt, search. Missing context is costlier than an extra query.`,
+When in doubt, search. Missing context is costlier than an extra query.
+
+SCOPE: Memories are stored globally across all projects. By default, search covers every project (results from the current project rank slightly higher and each result carries its project path). Pass scope: "project" when the query is clearly specific to the current repo — it cuts cross-project noise and scan cost.`,
   inputSchema: {
     type: "object",
     properties: {
@@ -148,6 +156,14 @@ When in doubt, search. Missing context is costlier than an extra query.`,
         description:
           "Natural language search query. Include relevant keywords, project names, or technical terms.",
       },
+      scope: {
+        type: "string",
+        description:
+          'Project scope: "all" (default) searches every project with a ranking boost for the current one; ' +
+          '"project" restricts to the current project; or pass an explicit canonical project path ' +
+          '(e.g. "/home/user/Development/other-repo") to search that project only.',
+        default: "all",
+      },
       intent: {
         type: "string",
         enum: ["continuity", "fact_check", "frequent", "associative", "explore"],
@@ -201,6 +217,21 @@ When in doubt, search. Missing context is costlier than an extra query.`,
         type: "string",
         description: "Filter conversation history results before this ISO date.",
       },
+      after: {
+        type: "string",
+        description:
+          "Filter memories created after this ISO date (e.g. '2025-06-01'). Applies to both memories and conversation history.",
+      },
+      before: {
+        type: "string",
+        description:
+          "Filter memories created before this ISO date (e.g. '2026-01-01'). Applies to both memories and conversation history.",
+      },
+      time_expr: {
+        type: "string",
+        description:
+          "Natural relative time filter, resolved to 'after' date. Examples: 'past 7 days', 'last 2 weeks', 'past 3 hours'. Ignored if explicit 'after' is provided.",
+      },
     },
     required: ["query", "intent", "reason_for_search"],
   },
@@ -258,7 +289,11 @@ Retrievable via get_waypoint. Only one waypoint per project—new waypoints over
   inputSchema: {
     type: "object",
     properties: {
-      project: { type: "string", description: "Project name." },
+      project: {
+        type: "string",
+        description:
+          "Project to save the waypoint under. Defaults to the current project (detected from cwd) — usually omit this.",
+      },
       branch: { type: "string", description: "Branch name (optional)." },
       summary: { type: "string", description: "2-3 sentences: primary goal, current status." },
       completed: {
@@ -292,7 +327,7 @@ Retrievable via get_waypoint. Only one waypoint per project—new waypoints over
         additionalProperties: true,
       },
     },
-    required: ["project", "summary"],
+    required: ["summary"],
   },
 };
 
@@ -306,7 +341,8 @@ export const getWaypointTool: Tool = {
       project: {
         type: "string",
         description:
-          "Project name to retrieve waypoint for. If omitted, retrieves the default (legacy) waypoint.",
+          "Project to retrieve the waypoint for (canonical absolute path). " +
+          "Defaults to the current project — only pass this to read another project's waypoint.",
       },
     },
   },