@jcyamacho/agent-memory 0.0.3 → 0.0.5

package/README.md

@@ -66,19 +66,17 @@ Recommended LLM instructions to pair with this MCP:
 Use `memory_recall` at task start and whenever prior preferences, project facts,
 or decisions may matter.
 
-Use `memory_remember` only for durable, reusable context: preferences,
-conventions, decisions, constraints, and stable workflow habits. Store one
-concise, self-contained fact per memory. Include `workspace` when available. Do
-not store secrets or temporary noise.
-
-For `memory_recall`, pass `terms` as 2-5 distinctive strings that describe what
-you are looking for. Prefer names, identifiers, package names, file names, and
-short phrases. Each term is matched independently — more terms cast a wider net,
-and results matching multiple terms rank higher. Stemming is applied
-automatically, so exact word forms are not required.
-
-Use `preferred_workspace` to bias ranking. Use `filter_workspace` and
-`created_*` only for exact scoping. Keep `limit` small.
+Use `memory_remember` only for durable context worth reusing later:
+preferences, conventions, decisions, constraints, and stable workflow habits.
+Store one concise fact per memory, include `workspace` when relevant, and avoid
+secrets or temporary notes.
+
+For `memory_recall`, pass 2-5 short, distinctive `terms` as separate array
+items. Prefer project names, file names, APIs, feature names, issue IDs, and
+brief phrases. Avoid one long sentence.
+
+Use `workspace` to bias results toward the current project. Use `created_*`
+only when time range matters.
 ```
 
 ## What It Stores
@@ -116,8 +114,7 @@ Inputs:
 - `terms` -> 2-5 distinctive terms or short phrases that should appear in the
   memory content; avoid full natural-language questions
 - `limit` -> maximum results to return
-- `preferred_workspace` -> ranking hint for a workspace
-- `filter_workspace` -> exact workspace filter
+- `workspace` -> workspace or repo path; biases ranking toward this workspace
 - `created_after` -> ISO 8601 lower bound
 - `created_before` -> ISO 8601 upper bound
 

package/dist/index.js

@@ -12464,7 +12464,7 @@ class StdioServerTransport {
   }
 }
 // package.json
-var version2 = "0.0.3";
+var version2 = "0.0.5";
 
 // src/config.ts
 import { homedir } from "node:os";
@@ -19881,6 +19881,9 @@ var EMPTY_COMPLETION_RESULT = {
   }
 };
 
+// src/memory-service.ts
+import { randomUUID } from "node:crypto";
+
 // src/errors.ts
 class MemoryError extends Error {
   code;
@@ -19905,6 +19908,63 @@ class PersistenceError extends MemoryError {
   }
 }
 
+// src/memory-service.ts
+var DEFAULT_LIMIT = 15;
+var MAX_LIMIT = 50;
+
+class MemoryService {
+  repository;
+  constructor(repository) {
+    this.repository = repository;
+  }
+  async save(input) {
+    const content = input.content.trim();
+    if (!content) {
+      throw new ValidationError("Memory content is required.");
+    }
+    const now = new Date;
+    const memory = {
+      id: randomUUID(),
+      content,
+      workspace: normalizeOptionalString(input.workspace),
+      createdAt: now,
+      updatedAt: now
+    };
+    return this.repository.save(memory);
+  }
+  async search(input) {
+    const terms = normalizeTerms(input.terms);
+    if (terms.length === 0) {
+      throw new ValidationError("At least one search term is required.");
+    }
+    const normalizedQuery = {
+      terms,
+      limit: normalizeLimit(input.limit),
+      workspace: normalizeOptionalString(input.workspace),
+      createdAfter: input.createdAfter,
+      createdBefore: input.createdBefore
+    };
+    return this.repository.search(normalizedQuery);
+  }
+}
+var normalizeLimit = (value) => {
+  if (value === undefined) {
+    return DEFAULT_LIMIT;
+  }
+  if (!Number.isInteger(value) || value < 1 || value > MAX_LIMIT) {
+    throw new ValidationError(`Limit must be an integer between 1 and ${MAX_LIMIT}.`);
+  }
+  return value;
+};
+var normalizeOptionalString = (value) => {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : undefined;
+};
+var normalizeTerms = (terms) => {
+  const normalizedTerms = terms.map((term) => term.trim()).filter(Boolean);
+  return [...new Set(normalizedTerms)];
+};
+
 // src/tools/shared.ts
 var toMcpError = (error2) => {
   if (error2 instanceof McpError) {
@@ -19932,34 +19992,32 @@ var parseOptionalDate = (value, fieldName) => {
 
 // src/tools/recall.ts
 var recallInputSchema = {
-  terms: array(string2()).min(1).describe("Search terms to match against remembered content. Use distinctive keywords, IDs, names, file names, or short phrases as separate items."),
-  limit: number2().int().min(1).max(20).optional().describe("Maximum number of memory results to return. Use a small number when you only need the best matches."),
-  preferred_workspace: string2().optional().describe("Preferred workspace or repository path to rank higher when relevant. This does not exclude other workspaces."),
-  filter_workspace: string2().optional().describe("Only return memories from this exact workspace or repository path."),
-  created_after: string2().optional().describe("Only return memories created at or after this ISO 8601 timestamp."),
-  created_before: string2().optional().describe("Only return memories created at or before this ISO 8601 timestamp.")
+  terms: array(string2()).min(1).describe("Search terms used to find relevant memories. Pass 2-5 short, distinctive items as separate array entries, such as project names, file names, APIs, feature names, issue IDs, or brief phrases. Avoid one long sentence."),
+  limit: number2().int().min(1).max(MAX_LIMIT).optional().describe("Maximum number of matches to return. Keep this small when you only need the strongest hits."),
+  workspace: string2().optional().describe("Preferred repository or workspace path for ranking. Use the current project path to bias results toward local context, while still allowing cross-workspace matches."),
+  created_after: string2().optional().describe("Only return memories created at or after this ISO 8601 timestamp. Use it when you need to narrow recall to newer context."),
+  created_before: string2().optional().describe("Only return memories created at or before this ISO 8601 timestamp. Use it when you need to narrow recall to older context.")
 };
 var recallOutputSchema = {
   results: array(object({
     id: string2().describe("Stable identifier for the remembered item."),
-    content: string2().describe("The remembered content that matched the search terms."),
-    score: number2().describe("Relevance score for this result. Higher means a better match."),
+    content: string2().describe("Saved memory text that matched one or more search terms."),
+    score: number2().describe("Relative relevance score for ranking results. Higher means a stronger match."),
     workspace: string2().optional().describe("Workspace associated with the memory, if available."),
     created_at: string2().describe("ISO 8601 timestamp showing when the memory was created.")
   }))
 };
 var registerRecallTool = (server, memoryService) => {
   server.registerTool("recall", {
-    description: "Retrieve previously remembered context that may help with the current task. Use it for user preferences, project facts, prior decisions, constraints, or earlier conversation details.",
+    description: "Recall previously saved context for the current task. Best results usually come from 2-5 short, distinctive terms such as project names, file names, APIs, decisions, or issue IDs.",
     inputSchema: recallInputSchema,
     outputSchema: recallOutputSchema
-  }, async ({ terms, limit, preferred_workspace, filter_workspace, created_after, created_before }) => {
+  }, async ({ terms, limit, workspace, created_after, created_before }) => {
     try {
       const results = await memoryService.search({
         terms,
         limit,
-        preferredWorkspace: preferred_workspace,
-        filterWorkspace: filter_workspace,
+        workspace,
         createdAfter: parseOptionalDate(created_after, "created_after"),
         createdBefore: parseOptionalDate(created_before, "created_before")
       });
@@ -20041,66 +20099,6 @@ var createMcpServer = (memoryService, version3) => {
   return server;
 };
 
-// src/memory-service.ts
-import { randomUUID } from "node:crypto";
-var DEFAULT_LIMIT = 5;
-var MAX_LIMIT = 20;
-
-class MemoryService {
-  repository;
-  constructor(repository) {
-    this.repository = repository;
-  }
-  async save(input) {
-    const content = input.content.trim();
-    if (!content) {
-      throw new ValidationError("Memory content is required.");
-    }
-    const now = new Date;
-    const memory = {
-      id: randomUUID(),
-      content,
-      workspace: normalizeOptionalString(input.workspace),
-      createdAt: now,
-      updatedAt: now
-    };
-    return this.repository.save(memory);
-  }
-  async search(input) {
-    const terms = normalizeTerms(input.terms);
-    if (terms.length === 0) {
-      throw new ValidationError("At least one search term is required.");
-    }
-    const normalizedQuery = {
-      terms,
-      limit: normalizeLimit(input.limit),
-      preferredWorkspace: normalizeOptionalString(input.preferredWorkspace),
-      filterWorkspace: normalizeOptionalString(input.filterWorkspace),
-      createdAfter: input.createdAfter,
-      createdBefore: input.createdBefore
-    };
-    const results = await this.repository.search(normalizedQuery);
-    return results.slice(0, normalizedQuery.limit);
-  }
-}
-var normalizeLimit = (value) => {
-  if (value === undefined) {
-    return DEFAULT_LIMIT;
-  }
-  if (!Number.isInteger(value) || value < 1 || value > MAX_LIMIT) {
-    throw new ValidationError(`Limit must be an integer between 1 and ${MAX_LIMIT}.`);
-  }
-  return value;
-};
-var normalizeOptionalString = (value) => {
-  const trimmed = value?.trim();
-  return trimmed ? trimmed : undefined;
-};
-var normalizeTerms = (terms) => {
-  const normalizedTerms = terms.map((term) => term.trim()).filter(Boolean);
-  return [...new Set(normalizedTerms)];
-};
-
 // src/sqlite-db.ts
 import { mkdirSync } from "node:fs";
 import { dirname } from "node:path";
@@ -20167,9 +20165,6 @@ var initializeMemoryDatabase = (database) => {
 };
 
 // src/sqlite-repository.ts
-var CANDIDATE_MULTIPLIER = 5;
-var MIN_CANDIDATES = 25;
-var MAX_CANDIDATES = 100;
 var WORKSPACE_BIAS = 0.1;
 
 class SqliteMemoryRepository {
@@ -20206,17 +20201,13 @@ class SqliteMemoryRepository {
       const selectParams = [];
       const whereParams = [toFtsQuery(query.terms)];
       let scoreExpr;
-      if (query.preferredWorkspace) {
+      if (query.workspace) {
         scoreExpr = "MAX(0, -bm25(memories_fts) + CASE WHEN m.workspace = ? THEN ? ELSE 0.0 END)";
-        selectParams.push(query.preferredWorkspace, WORKSPACE_BIAS);
+        selectParams.push(query.workspace, WORKSPACE_BIAS);
       } else {
         scoreExpr = "MAX(0, -bm25(memories_fts))";
       }
       const whereClauses = ["memories_fts MATCH ?"];
-      if (query.filterWorkspace) {
-        whereClauses.push("m.workspace = ?");
-        whereParams.push(query.filterWorkspace);
-      }
       if (query.createdAfter) {
         whereClauses.push("m.created_at >= ?");
         whereParams.push(query.createdAfter.getTime());
@@ -20225,7 +20216,7 @@ class SqliteMemoryRepository {
         whereClauses.push("m.created_at <= ?");
         whereParams.push(query.createdBefore.getTime());
       }
-      const params = [...selectParams, ...whereParams, toCandidateLimit(query.limit)];
+      const params = [...selectParams, ...whereParams, query.limit];
       const statement = this.database.prepare(`
         SELECT
           m.id,
@@ -20254,7 +20245,6 @@ class SqliteMemoryRepository {
     }
   }
 }
-var toCandidateLimit = (limit) => Math.min(Math.max(limit * CANDIDATE_MULTIPLIER, MIN_CANDIDATES), MAX_CANDIDATES);
 var toFtsQuery = (terms) => terms.map(toFtsTerm).join(" OR ");
 var toFtsTerm = (term) => {
   const escaped = term.replaceAll('"', '""');

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jcyamacho/agent-memory",
   "main": "dist/index.js",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "bin": {
     "agent-memory": "dist/index.js"
   },