@prom.codes/memory-mcp 0.15.0 → 0.15.2

package/README.md

@@ -55,11 +55,22 @@ work, is a newer version published?). Secrets are rejected on every write.
 Your memories never leave your machine (only short query/record text
 transits when embeddings are enabled).
 
-## Native modules
+## Native modules — no install script needed
 
-Uses `better-sqlite3` (native). Prebuilt binaries are fetched automatically on
-common platforms (macOS x64/arm64, Linux x64/arm64, Windows x64) — no compiler
-needed. On an unsupported platform/Node ABI, install C/C++ build tools so the
-module can compile (Windows: VS Build Tools). Requires Node ≥ 20.10.
+Uses `better-sqlite3` (native), but **nothing is built on your machine and no
+install script runs**. The addon ships prebuilt in a platform package
+(`@prom.codes/native-<platform>`) listed as an optional dependency: npm picks
+the one matching your `os`/`cpu`/`libc` and installs it by copying files. So a
+hardened npm needs no special handling — `ignore-scripts=true` (a sensible
+policy, and npm v12's default) has nothing left to suppress:
+```bash
+npm install -g @prom.codes/memory-mcp
+```
+
+Prebuilt for macOS / Linux (glibc + musl) / Windows on x64 + arm64, Node 22, 24,
+25 and 26. **Requires Node ≥ 22** — upstream `better-sqlite3` publishes no
+prebuild for Node 20's ABI. On an unshipped combination the install still
+succeeds and falls back to building from source, which needs install scripts
+allowed (`--allow-scripts=better-sqlite3`) and C/C++ build tools.
 
 Docs: https://prom.codes/docs/mcp/memory

package/dist/bin.js

@@ -40,12 +40,8 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { fileURLToPath } from "node:url";
 var UPGRADE_BASE = "npm install -g @prom.codes/context-mcp @prom.codes/memory-mcp @prom.codes/saver";
-var NATIVE_BUILD_PACKAGES = "better-sqlite3,tree-sitter";
-function upgradeCommandFor(npmMajor) {
-  if (npmMajor !== null && npmMajor >= 12) {
-    return `${UPGRADE_BASE} --allow-scripts=${NATIVE_BUILD_PACKAGES}`;
-  }
-  return `${UPGRADE_BASE} --ignore-scripts=false --foreground-scripts`;
+function upgradeCommandFor(_npmMajor) {
+  return UPGRADE_BASE;
 }
 var UPGRADE_COMMAND = upgradeCommandFor(null);
 var npmMajorPromise;
@@ -2692,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);
@@ -3988,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) }]
@@ -4013,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;
@@ -4030,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(),
@@ -4117,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,
@@ -4137,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", {
@@ -4289,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", {
@@ -4437,7 +4499,7 @@ ${f.value}`);
         embeddingsError = err instanceof Error ? err.message : String(err);
       }
     }
-    const update = await buildUpdateStatus("@prom.codes/memory-mcp", "0.15.0", { isDevBuild: false });
+    const update = await buildUpdateStatus("@prom.codes/memory-mcp", "0.15.2", { isDevBuild: false });
     let recorder;
     try {
       const scopes = ["project-local", "project", "user"];
@@ -4519,7 +4581,7 @@ ${f.value}`);
 // dist/server.js
 var SERVER_IDENTITY = {
   name: "prometheus-memory-mcp",
-  version: "0.15.0",
+  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.";
@@ -4528,7 +4590,19 @@ var SERVER_INSTRUCTIONS = "Persistent agent memory for this workspace \u2014 USE
 function looksLikeMissingNativeBinding(msg) {
   return /bindings file|better_sqlite3\.node|could not locate the bindings|node_module_version|was compiled against a different|invalid elf|\.node['"\s]/i.test(msg);
 }
-var NATIVE_BINDING_HINT = '\nThis looks like the native `better-sqlite3` module failed to load \u2014 the\ninstall script that builds it was skipped, so the binary was never produced.\nOn npm v12+ install scripts are opt-in by default; on older npm it\'s usually\n`ignore-scripts=true` hardening. Install globally, allowing the native build,\nthen point Claude Code at the built binary instead of npx:\n  npm v12+:  npm install -g @prom.codes/memory-mcp --allow-scripts=better-sqlite3\n  npm \u2264 11:  npm install -g @prom.codes/memory-mcp --ignore-scripts=false --foreground-scripts\n  claude mcp add memory -- node "$(npm root -g)/@prom.codes/memory-mcp/dist/bin.js"\nDocs: https://prom.codes/docs/guides/troubleshooting#could-not-locate-the-bindings-file\n';
+var NATIVE_BINDING_HINT = `
+The native SQLite module failed to load. Since 0.15.0 the addon ships
+prebuilt in a platform package (no install script runs), so this almost always
+means we ship no build for THIS platform + Node combination:
+  you are on ${process.platform}-${process.arch}, Node ${process.versions.node} (ABI v${process.versions.modules})
+  shipped: win32/darwin/linux (glibc+musl) x x64/arm64, on Node 22, 24, 25, 26
+Most likely fix \u2014 use a supported Node (22+); Node 20 has no prebuilt addon
+upstream and must compile from source. To build from source instead, allow the
+install scripts:
+  npm install -g @prom.codes/memory-mcp --allow-scripts=better-sqlite3   # npm v12+
+  npm install -g @prom.codes/memory-mcp --ignore-scripts=false --foreground-scripts  # npm <= 11
+Docs: https://prom.codes/docs/guides/troubleshooting#could-not-locate-the-bindings-file
+`;
 async function main() {
   const env = process.env;
   const explicitRoot = (env.PROMETHEUS_WORKSPACE_ROOT ?? "").trim();

package/package.json

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