@prom.codes/memory-mcp 0.15.1 → 0.15.2

package/dist/bin.js

@@ -2688,7 +2688,8 @@ var SqliteMemoryBackend = class {
     const rows = this.db.prepare(sql).all(...params);
     const resolved = resolveScopeChain(rows.map(rowToRecord), query.chain);
     const deduped = this.dedupeRecords(resolved);
-    const limited = query.limit !== void 0 ? deduped.slice(0, query.limit) : deduped;
+    const offset = query.offset ?? 0;
+    const limited = query.limit !== void 0 ? deduped.slice(offset, offset + query.limit) : deduped.slice(offset);
     const bump = this.db.prepare(`UPDATE agent_memory SET use_count = use_count + 1 WHERE id = ?`);
     for (const rec of limited) {
       bump.run(rec.id);
@@ -3984,8 +3985,10 @@ function weave(records, options = {}) {
 
 // dist/tools.js
 var MAX_LIMIT = 100;
-var DEFAULT_READ_LIMIT = 50;
+var DEFAULT_READ_LIMIT = 25;
 var MAX_VALUE_CHARS = 64 * 1024;
+var RECORDS_TOKEN_BUDGET = 5e3;
+var MAX_VALUE_CHARS_IN_VIEW = 4e3;
 function textResult(payload) {
   return {
     content: [{ type: "text", text: JSON.stringify(payload, null, 2) }]
@@ -4009,6 +4012,52 @@ function recordToJson(rec) {
     updatedAt: rec.updatedAt
   };
 }
+function recordToJsonPreview(rec, maxValueChars) {
+  const view = recordToJson(rec);
+  if (rec.value.length > maxValueChars) {
+    const omitted = rec.value.length - maxValueChars;
+    view.value = `${rec.value.slice(0, maxValueChars)}
+\u2026[+${omitted} chars omitted \u2014 use \`search\` for the full value]`;
+    view.valueTruncated = true;
+    view.valueChars = rec.value.length;
+  }
+  return view;
+}
+function boundRecordsForResult(records) {
+  const views = [];
+  let valuesPreviewed = 0;
+  let tokens = 0;
+  let overBudget = false;
+  for (const rec of records) {
+    const view = recordToJsonPreview(rec, MAX_VALUE_CHARS_IN_VIEW);
+    if (view.valueTruncated === true)
+      valuesPreviewed += 1;
+    const cost = estimateTokens(JSON.stringify(view));
+    if (views.length > 0 && tokens + cost > RECORDS_TOKEN_BUDGET) {
+      overBudget = true;
+      break;
+    }
+    views.push(view);
+    tokens += cost;
+  }
+  return { views, shown: views.length, fetched: records.length, valuesPreviewed, overBudget };
+}
+function boundedRecordsNote(b, opts) {
+  if (!b.overBudget && b.valuesPreviewed === 0 && b.fetched < opts.limit)
+    return void 0;
+  const parts = [];
+  if (b.overBudget) {
+    parts.push(`Showing ${b.shown} of ${b.fetched} fetched records \u2014 the result was trimmed to stay under the token budget. The \`woven\` block already carries the highest-value facts within its own cap.`);
+  }
+  if (b.valuesPreviewed > 0) {
+    parts.push(`${b.valuesPreviewed} value(s) previewed to ${MAX_VALUE_CHARS_IN_VIEW} chars.`);
+  }
+  if (b.fetched >= opts.limit) {
+    parts.push(`More records may exist beyond limit=${opts.limit}.`);
+  }
+  parts.push(`To see more: narrow with \`types\`, page with \`offset\` (e.g. offset=${(opts.offset ?? 0) + b.shown}), raise \`limit\`, or use \`search\` for specific facts.`);
+  return parts.join(" ");
+}
 function clampLimit(limit, def) {
   if (limit === void 0)
     return def;
@@ -4026,7 +4075,9 @@ var scopeEnum = z.enum(MEMORY_SCOPES);
 var typeEnum = z.enum(MEMORY_TYPES);
 var readInput = {
   types: z.array(typeEnum).min(1).optional(),
-  limit: z.number().int().positive().max(MAX_LIMIT).optional()
+  limit: z.number().int().positive().max(MAX_LIMIT).optional(),
+  /** Skip the first N resolved records — page through large memory sets. */
+  offset: z.number().int().nonnegative().optional()
 };
 var writeInput = {
   scope: scopeEnum.optional(),
@@ -4113,19 +4164,23 @@ function registerTools(server, source, hooks = {}) {
   }));
   reg("read", {
     title: "Recall agent memory",
-    description: "Read agent memory for this project along the scope chain (project \u2192 workspace \u2192 tenant \u2192 system; narrowest scope wins). Syncs `.prometheus/memories/*.md` first, then returns the resolved records plus a prompt-ready `woven` markdown block (token-capped). Call this at the START of a session or task to recall what earlier sessions learned.",
+    description: "Read agent memory for this project along the scope chain (project \u2192 workspace \u2192 tenant \u2192 system; narrowest scope wins). Syncs `.prometheus/memories/*.md` first, then returns the resolved records plus a prompt-ready `woven` markdown block (token-capped). The `records` array is bounded to a token budget; a `note` explains how to page (`offset`) or narrow (`types`, `search`) when trimmed. Call this at the START of a session or task to recall what earlier sessions learned.",
     inputSchema: readInput
   }, async (args) => {
     const deps = await ready();
     const { backend, workspaceRoot, projectId, projectName } = deps;
     const mirrorToFiles = !deps.rootIsHomeOrFsRoot;
     const limit = clampLimit(args.limit, DEFAULT_READ_LIMIT);
+    const offset = args.offset ?? 0;
     const sync = mirrorToFiles ? await syncProjectFiles(backend, { projectId, workspaceRoot }) : { synced: 0, pruned: 0, skipped: [] };
     const records = await backend.read({
       chain: defaultScopeChain(projectId),
       types: args.types,
-      limit
+      limit,
+      offset
     });
+    const bounded = boundRecordsForResult(records);
+    const note = boundedRecordsNote(bounded, { limit, offset });
     return textResult({
       projectId,
       projectName,
@@ -4133,7 +4188,12 @@ function registerTools(server, source, hooks = {}) {
       projectFilesPruned: sync.pruned,
       ...sync.skipped.length > 0 ? { skippedFiles: sync.skipped } : {},
       woven: weave(records),
-      records: records.map(recordToJson)
+      recordsShown: bounded.shown,
+      recordsFetched: bounded.fetched,
+      limit,
+      offset,
+      ...note !== void 0 ? { note } : {},
+      records: bounded.views
     });
   });
   reg("write", {
@@ -4285,11 +4345,17 @@ ${f.value}`);
       keyContains: args.keyContains,
       limit
     });
+    const bounded = boundRecordsForResult(records);
+    const note = boundedRecordsNote(bounded, { limit });
     return textResult({
       projectId,
       projectName,
       dbPath,
-      records: records.map(recordToJson)
+      recordsShown: bounded.shown,
+      recordsFetched: bounded.fetched,
+      limit,
+      ...note !== void 0 ? { note } : {},
+      records: bounded.views
     });
   });
   reg("delete", {
@@ -4433,7 +4499,7 @@ ${f.value}`);
         embeddingsError = err instanceof Error ? err.message : String(err);
       }
     }
-    const update = await buildUpdateStatus("@prom.codes/memory-mcp", "0.15.1", { isDevBuild: false });
+    const update = await buildUpdateStatus("@prom.codes/memory-mcp", "0.15.2", { isDevBuild: false });
     let recorder;
     try {
       const scopes = ["project-local", "project", "user"];
@@ -4515,7 +4581,7 @@ ${f.value}`);
 // dist/server.js
 var SERVER_IDENTITY = {
   name: "prometheus-memory-mcp",
-  version: "0.15.1",
+  version: "0.15.2",
   title: "prom.codes Memory"
 };
 var SERVER_INSTRUCTIONS = "Persistent agent memory for this workspace \u2014 USE IT PROACTIVELY; the user will not tell you to. Protocol:\n1. ONE-TIME: if this workspace has no Prometheus memory rule yet, call memory_setup now (idempotent) so the protocol is installed into the runtime rule files and survives future sessions. (The server also auto-installs it on startup when a project rule file already exists \u2014 memory_setup covers the rest.)\n2. SESSION START: before any non-trivial task, call memory_read to recall facts, decisions and procedures from earlier sessions.\n3. DURING WORK: when the user states a durable preference, decision, correction or project fact, store it with memory_write (semantic for facts, procedural for how-tos) \u2014 without being asked.\n4. LOOK-UP: use memory_search for keyword recall when memory_read is not specific enough.\n5. SESSION END: consolidate what was learned with memory_capture.\nCall memory_status anytime to check what is stored and whether the rule is installed. Never store secrets, API keys or credentials \u2014 such writes are rejected.";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prom.codes/memory-mcp",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "description": "prom.codes Memory — persistent, local-first agent memory as an MCP server.",
   "type": "module",
   "bin": {