@jcyamacho/agent-memory 0.0.4 → 0.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +11 -13
  2. package/dist/index.js +9 -9
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -66,19 +66,17 @@ Recommended LLM instructions to pair with this MCP:
66
66
  Use `memory_recall` at task start and whenever prior preferences, project facts,
67
67
  or decisions may matter.
68
68
 
69
- Use `memory_remember` only for durable, reusable context: preferences,
70
- conventions, decisions, constraints, and stable workflow habits. Store one
71
- concise, self-contained fact per memory. Include `workspace` when available. Do
72
- not store secrets or temporary noise.
73
-
74
- For `memory_recall`, pass `terms` as 2-5 distinctive strings that describe what
75
- you are looking for. Prefer names, identifiers, package names, file names, and
76
- short phrases. Each term is matched independently — more terms cast a wider net,
77
- and results matching multiple terms rank higher. Stemming is applied
78
- automatically, so exact word forms are not required.
79
-
80
- Use `workspace` to bias ranking toward the current project. Use `created_*`
81
- only for exact scoping.
69
+ Use `memory_remember` only for durable context worth reusing later:
70
+ preferences, conventions, decisions, constraints, and stable workflow habits.
71
+ Store one concise fact per memory, include `workspace` when relevant, and avoid
72
+ secrets or temporary notes.
73
+
74
+ For `memory_recall`, pass 2-5 short, distinctive `terms` as separate array
75
+ items. Prefer project names, file names, APIs, feature names, issue IDs, and
76
+ brief phrases. Avoid one long sentence.
77
+
78
+ Use `workspace` to bias results toward the current project. Use `created_*`
79
+ only when time range matters.
82
80
  ```
83
81
 
84
82
  ## What It Stores
package/dist/index.js CHANGED
@@ -12464,7 +12464,7 @@ class StdioServerTransport {
12464
12464
  }
12465
12465
  }
12466
12466
  // package.json
12467
- var version2 = "0.0.4";
12467
+ var version2 = "0.0.5";
12468
12468
 
12469
12469
  // src/config.ts
12470
12470
  import { homedir } from "node:os";
@@ -19992,24 +19992,24 @@ var parseOptionalDate = (value, fieldName) => {
19992
19992
 
19993
19993
  // src/tools/recall.ts
19994
19994
  var recallInputSchema = {
19995
- 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."),
19996
- limit: number2().int().min(1).max(MAX_LIMIT).optional().describe("Maximum number of memory results to return. Use a small number when you only need the best matches."),
19997
- workspace: string2().optional().describe("Workspace or repository path. Memories from this workspace rank higher, but other workspaces are not excluded."),
19998
- created_after: string2().optional().describe("Only return memories created at or after this ISO 8601 timestamp."),
19999
- created_before: string2().optional().describe("Only return memories created at or before this ISO 8601 timestamp.")
19995
+ 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."),
19996
+ 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."),
19997
+ 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."),
19998
+ 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."),
19999
+ 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.")
20000
20000
  };
20001
20001
  var recallOutputSchema = {
20002
20002
  results: array(object({
20003
20003
  id: string2().describe("Stable identifier for the remembered item."),
20004
- content: string2().describe("The remembered content that matched the search terms."),
20005
- score: number2().describe("Relevance score for this result. Higher means a better match."),
20004
+ content: string2().describe("Saved memory text that matched one or more search terms."),
20005
+ score: number2().describe("Relative relevance score for ranking results. Higher means a stronger match."),
20006
20006
  workspace: string2().optional().describe("Workspace associated with the memory, if available."),
20007
20007
  created_at: string2().describe("ISO 8601 timestamp showing when the memory was created.")
20008
20008
  }))
20009
20009
  };
20010
20010
  var registerRecallTool = (server, memoryService) => {
20011
20011
  server.registerTool("recall", {
20012
- 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.",
20012
+ 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.",
20013
20013
  inputSchema: recallInputSchema,
20014
20014
  outputSchema: recallOutputSchema
20015
20015
  }, async ({ terms, limit, workspace, created_after, created_before }) => {
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@jcyamacho/agent-memory",
3
3
  "main": "dist/index.js",
4
- "version": "0.0.4",
4
+ "version": "0.0.5",
5
5
  "bin": {
6
6
  "agent-memory": "dist/index.js"
7
7
  },