@j0hanz/memory-mcp 1.0.1 → 1.2.0

package/dist/tools/search-memories.js

@@ -2,18 +2,20 @@ import { E_UNKNOWN, getErrorMessage, rethrowMcpError } from '../lib/errors.js';
 import { splitPage } from '../lib/pagination.js';
 import { buildSearchCursorScope, decodeSearchCursor, encodeSearchCursor, } from '../lib/search-cursor.js';
 import { loadRankedSearchRows, toMemoryFilters } from '../lib/search.js';
+import { getToolContract } from '../lib/tool-contracts.js';
 import { createErrorResponse, createToolResponse, } from '../lib/tool-response.js';
 import { parseMemoryRow } from '../lib/types.js';
-import { SearchMemoriesInputSchema } from '../schemas/inputs.js';
-import { SearchResultSchema } from '../schemas/outputs.js';
+import {} from '../schemas/inputs.js';
+import {} from '../schemas/outputs.js';
 import { wrapToolHandler } from './progress.js';
 export function registerSearchMemories(server, db) {
-    server.registerTool('search_memories', {
-        title: 'Search Memories',
-        description: 'Full-text search over memory content and tags using FTS5. Returns ranked results with pagination support via cursor. Query terms are matched individually; FTS5 phrase operators and negation are not supported.',
-        inputSchema: SearchMemoriesInputSchema,
-        outputSchema: SearchResultSchema,
-        annotations: { readOnlyHint: true, openWorldHint: false },
+    const contract = getToolContract('search_memories');
+    server.registerTool(contract.name, {
+        title: contract.title,
+        description: contract.description,
+        inputSchema: contract.inputSchema,
+        outputSchema: contract.outputSchema,
+        annotations: contract.annotations,
     }, wrapToolHandler((params) => {
         try {
             const { limit, cursor } = params;

package/dist/tools/search-memories.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-memories.js","sourceRoot":"","sources":["../../src/tools/search-memories.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search-memories.js","sourceRoot":"","sources":["../../src/tools/search-memories.ts"],"names":[],"mappings":"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"}

package/dist/tools/store-memories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store-memories.d.ts","sourceRoot":"","sources":["../../src/tools/store-memories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA+B9C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAmE1E"}
+{"version":3,"file":"store-memories.d.ts","sourceRoot":"","sources":["../../src/tools/store-memories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA2B9C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAoE1E"}

package/dist/tools/store-memories.js

@@ -1,15 +1,12 @@
 import { E_UNKNOWN, getErrorMessage, rethrowMcpError } from '../lib/errors.js';
 import { computeMemoryHash } from '../lib/hash.js';
 import { logToolEvent, notifyMemoryResourceUpdated } from '../lib/mcp-utils.js';
+import { INSERT_MEMORY_SQL } from '../lib/sql.js';
+import { getToolContract } from '../lib/tool-contracts.js';
 import { createErrorResponse, createToolResponse, } from '../lib/tool-response.js';
-import { StoreMemoriesInputSchema } from '../schemas/inputs.js';
-import { BatchResultSchema } from '../schemas/outputs.js';
+import {} from '../schemas/inputs.js';
+import {} from '../schemas/outputs.js';
 import { wrapToolHandler } from './progress.js';
-const INSERT_MEMORY_SQL = `INSERT OR IGNORE INTO memories (hash, content, tags, memory_type, importance, created_at, updated_at)
-  VALUES (?, ?, ?, ?, ?, ?, ?)`;
-function countCreated(items) {
-    return items.reduce((count, item) => (item.created ? count + 1 : count), 0);
-}
 async function notifyCreatedResources(server, items) {
     const notifications = items
         .filter((item) => item.created)
@@ -17,12 +14,13 @@ async function notifyCreatedResources(server, items) {
     await Promise.allSettled(notifications);
 }
 export function registerStoreMemories(server, db) {
-    server.registerTool('store_memories', {
-        title: 'Store Memories (Batch)',
-        description: 'Store up to 50 memories in a single atomic transaction. Returns per-item results so callers can detect partial failures. All items succeed or the transaction rolls back.',
-        inputSchema: StoreMemoriesInputSchema,
-        outputSchema: BatchResultSchema,
-        annotations: { idempotentHint: true, openWorldHint: false },
+    const contract = getToolContract('store_memories');
+    server.registerTool(contract.name, {
+        title: contract.title,
+        description: contract.description,
+        inputSchema: contract.inputSchema,
+        outputSchema: contract.outputSchema,
+        annotations: contract.annotations,
     }, wrapToolHandler(async (params) => {
         try {
             const now = new Date().toISOString();
@@ -43,8 +41,14 @@ export function registerStoreMemories(server, db) {
                 }
                 return items;
             });
-            const created = countCreated(results);
-            const succeeded = results.reduce((count, item) => (item.ok ? count + 1 : count), 0);
+            let created = 0;
+            let succeeded = 0;
+            for (const item of results) {
+                if (item.ok)
+                    succeeded += 1;
+                if (item.created)
+                    created += 1;
+            }
             const failed = results.length - succeeded;
             await logToolEvent(server, 'store_memories', {
                 total: results.length,

package/dist/tools/store-memories.js.map

@@ -1 +1 @@
-{"version":3,"file":"store-memories.js","sourceRoot":"","sources":["../../src/tools/store-memories.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"store-memories.js","sourceRoot":"","sources":["../../src/tools/store-memories.ts"],"names":[],"mappings":"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"}

package/dist/tools/store-memory.js

@@ -1,12 +1,12 @@
 import { E_UNKNOWN, getErrorMessage, rethrowMcpError } from '../lib/errors.js';
 import { computeMemoryHash } from '../lib/hash.js';
 import { logToolEvent, notifyMemoryResourceUpdated } from '../lib/mcp-utils.js';
+import { INSERT_MEMORY_SQL } from '../lib/sql.js';
+import { getToolContract } from '../lib/tool-contracts.js';
 import { createErrorResponse, createToolResponse, } from '../lib/tool-response.js';
-import { StoreMemoryInputSchema } from '../schemas/inputs.js';
-import { StoreResultSchema } from '../schemas/outputs.js';
+import {} from '../schemas/inputs.js';
+import {} from '../schemas/outputs.js';
 import { wrapToolHandler } from './progress.js';
-const INSERT_MEMORY_SQL = `INSERT OR IGNORE INTO memories (hash, content, tags, memory_type, importance, created_at, updated_at)
-  VALUES (?, ?, ?, ?, ?, ?, ?)`;
 function toInsertParams(params, hash, memoryType, now) {
     return [
         hash,
@@ -25,12 +25,13 @@ function insertMemory(db, params, hash, memoryType, now) {
     return insertResult.changes > 0;
 }
 export function registerStoreMemory(server, db) {
-    server.registerTool('store_memory', {
-        title: 'Store Memory',
-        description: 'Store a new memory with content, tags, and optional type/importance. Returns the SHA-256 hash. Idempotent — storing the same content+tags returns the existing hash with created:false.',
-        inputSchema: StoreMemoryInputSchema,
-        outputSchema: StoreResultSchema,
-        annotations: { idempotentHint: true, openWorldHint: false },
+    const contract = getToolContract('store_memory');
+    server.registerTool(contract.name, {
+        title: contract.title,
+        description: contract.description,
+        inputSchema: contract.inputSchema,
+        outputSchema: contract.outputSchema,
+        annotations: contract.annotations,
     }, wrapToolHandler(async (params) => {
         try {
             const memoryType = params.memory_type ?? 'general';

package/dist/tools/store-memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"store-memory.js","sourceRoot":"","sources":["../../src/tools/store-memory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGhD,MAAM,iBAAiB,GAAG;+BACK,CAAC;AAEhC,SAAS,cAAc,CACrB,MAA2D,EAC3D,IAAY,EACZ,UAAkB,EAClB,GAAW;IAEX,OAAO;QACL,IAAI;QACJ,MAAM,CAAC,OAAO;QACd,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3B,UAAU;QACV,MAAM,CAAC,UAAU;QACjB,GAAG;QACH,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,EAAW,EACX,MAAkB,EAClB,IAAY,EACZ,UAAkB,EAClB,GAAW;IAEX,MAAM,YAAY,GAAG,EAAE;SACpB,WAAW,CAAC,iBAAiB,CAAC;SAC9B,GAAG,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IACzD,OAAO,YAAY,CAAC,OAAO,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,EAAW;IAChE,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,yLAAyL;QAC3L,WAAW,EAAE,sBAAsB;QACnC,YAAY,EAAE,iBAAiB;QAC/B,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC5D,EACD,eAAe,CACb,KAAK,EAAE,MAAkB,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,IAAI,SAAS,CAAC;YACnD,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;YAChE,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACvD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAClD,CAAC;YAED,OAAO,kBAAkB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,EACD;QACE,eAAe,EAAE,CAAC,MAAkB,EAAE,EAAE,CACtC,mBAAmB,MAAM,CAAC,IAAI,CAAC,MAAM,gBAAgB;KACxD,CACF,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"store-memory.js","sourceRoot":"","sources":["../../src/tools/store-memory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAA+B,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAA0B,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIhD,SAAS,cAAc,CACrB,MAA2D,EAC3D,IAAY,EACZ,UAAkB,EAClB,GAAW;IAEX,OAAO;QACL,IAAI;QACJ,MAAM,CAAC,OAAO;QACd,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3B,UAAU;QACV,MAAM,CAAC,UAAU;QACjB,GAAG;QACH,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,EAAW,EACX,MAAkB,EAClB,IAAY,EACZ,UAAkB,EAClB,GAAW;IAEX,MAAM,YAAY,GAAG,EAAE;SACpB,WAAW,CAAC,iBAAiB,CAAC;SAC9B,GAAG,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;IACzD,OAAO,YAAY,CAAC,OAAO,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,EAAW;IAChE,MAAM,QAAQ,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;IACjD,MAAM,CAAC,YAAY,CACjB,QAAQ,CAAC,IAAI,EACb;QACE,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,WAAW,EAAE,QAAQ,CAAC,WAA4C;QAClE,YAAY,EAAE,QAAQ,CAAC,YAAwC;QAC/D,WAAW,EAAE,QAAQ,CAAC,WAAW;KAClC,EACD,eAAe,CACb,KAAK,EAAE,MAAkB,EAAE,EAAE;QAC3B,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,IAAI,SAAS,CAAC;YACnD,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;YAChE,MAAM,YAAY,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACvD,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAClD,CAAC;YAED,OAAO,kBAAkB,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAe,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,EACD;QACE,eAAe,EAAE,CAAC,MAAkB,EAAE,EAAE,CACtC,mBAAmB,MAAM,CAAC,IAAI,CAAC,MAAM,gBAAgB;KACxD,CACF,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/update-memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-memory.d.ts","sourceRoot":"","sources":["../../src/tools/update-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAsC9C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAyEzE"}
+{"version":3,"file":"update-memory.d.ts","sourceRoot":"","sources":["../../src/tools/update-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AA8C9C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAsFzE"}

package/dist/tools/update-memory.js

@@ -1,16 +1,16 @@
 import { E_CONFLICT, E_NOT_FOUND, E_UNKNOWN, getErrorMessage, rethrowMcpError, } from '../lib/errors.js';
 import { computeMemoryHash } from '../lib/hash.js';
 import { logToolEvent, notifyMemoryResourceUpdated } from '../lib/mcp-utils.js';
+import { SELECT_MEMORY_BY_HASH_SQL, SELECT_MEMORY_HASH_SQL, } from '../lib/sql.js';
+import { getToolContract } from '../lib/tool-contracts.js';
 import { createErrorResponse, createToolResponse, } from '../lib/tool-response.js';
 import { parseTags } from '../lib/types.js';
-import { UpdateMemoryInputSchema } from '../schemas/inputs.js';
-import { UpdateResultSchema } from '../schemas/outputs.js';
+import {} from '../schemas/inputs.js';
+import {} from '../schemas/outputs.js';
 import { wrapToolHandler } from './progress.js';
 const UPDATE_MEMORY_SQL = `UPDATE memories
   SET hash = ?, content = ?, tags = ?, updated_at = ?
   WHERE hash = ?`;
-const SELECT_MEMORY_BY_HASH_SQL = 'SELECT * FROM memories WHERE hash = ?';
-const SELECT_MEMORY_HASH_SQL = 'SELECT hash FROM memories WHERE hash = ?';
 async function notifyUpdatedMemoryResources(server, oldHash, newHash) {
     const notifications = [notifyMemoryResourceUpdated(server, oldHash)];
     if (newHash !== oldHash) {
@@ -19,42 +19,57 @@ async function notifyUpdatedMemoryResources(server, oldHash, newHash) {
     await Promise.allSettled(notifications);
 }
 export function registerUpdateMemory(server, db) {
-    server.registerTool('update_memory', {
-        title: 'Update Memory',
-        description: 'Replace the content of an existing memory identified by its hash. Tags may optionally be replaced. Returns the new hash.',
-        inputSchema: UpdateMemoryInputSchema,
-        outputSchema: UpdateResultSchema,
-        annotations: { destructiveHint: true, openWorldHint: false },
+    const contract = getToolContract('update_memory');
+    server.registerTool(contract.name, {
+        title: contract.title,
+        description: contract.description,
+        inputSchema: contract.inputSchema,
+        outputSchema: contract.outputSchema,
+        annotations: contract.annotations,
     }, wrapToolHandler(async (params) => {
         try {
-            const existing = db
-                .prepareOnce(SELECT_MEMORY_BY_HASH_SQL)
-                .get(params.hash);
-            if (!existing) {
-                return createErrorResponse(E_NOT_FOUND, `Memory not found: ${params.hash}`);
-            }
-            const newTags = params.tags ?? parseTags(existing.tags);
-            const newHash = computeMemoryHash(params.content, newTags);
-            if (newHash !== params.hash) {
-                const collision = db
-                    .prepareOnce(SELECT_MEMORY_HASH_SQL)
-                    .get(newHash);
-                if (collision) {
-                    return createErrorResponse(E_CONFLICT, `Memory already exists for target content/tags: ${newHash}`);
+            // All reads and the write are inside a single IMMEDIATE transaction
+            // to prevent TOCTOU between existence/collision checks and UPDATE.
+            const txResult = db.transaction(() => {
+                const existing = db
+                    .prepareOnce(SELECT_MEMORY_BY_HASH_SQL)
+                    .get(params.hash);
+                if (!existing) {
+                    return {
+                        ok: false,
+                        code: E_NOT_FOUND,
+                        message: `Memory not found: ${params.hash}`,
+                    };
                 }
-            }
-            const now = new Date().toISOString();
-            db.transaction(() => {
+                const newTags = params.tags ?? parseTags(existing.tags);
+                const newHash = computeMemoryHash(params.content, newTags);
+                if (newHash !== params.hash) {
+                    const collision = db
+                        .prepareOnce(SELECT_MEMORY_HASH_SQL)
+                        .get(newHash);
+                    if (collision) {
+                        return {
+                            ok: false,
+                            code: E_CONFLICT,
+                            message: `Memory already exists for target content/tags: ${newHash}`,
+                        };
+                    }
+                }
+                const now = new Date().toISOString();
                 db.prepareOnce(UPDATE_MEMORY_SQL).run(newHash, params.content, JSON.stringify(newTags), now, params.hash);
+                return { ok: true, oldHash: params.hash, newHash };
             });
+            if (!txResult.ok) {
+                return createErrorResponse(txResult.code, txResult.message);
+            }
             await logToolEvent(server, 'update', {
-                oldHash: params.hash,
-                newHash,
+                oldHash: txResult.oldHash,
+                newHash: txResult.newHash,
             });
-            await notifyUpdatedMemoryResources(server, params.hash, newHash);
+            await notifyUpdatedMemoryResources(server, txResult.oldHash, txResult.newHash);
             return createToolResponse({
-                old_hash: params.hash,
-                new_hash: newHash,
+                old_hash: txResult.oldHash,
+                new_hash: txResult.newHash,
             });
         }
         catch (err) {

package/dist/tools/update-memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-memory.js","sourceRoot":"","sources":["../../src/tools/update-memory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update-memory.js","sourceRoot":"","sources":["../../src/tools/update-memory.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@j0hanz/memory-mcp",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "mcpName": "io.github.j0hanz/memory-mcp",
   "author": "Johanz",
   "license": "MIT",
@@ -37,7 +37,6 @@
   ],
   "scripts": {
     "clean": "node scripts/tasks.mjs clean",
-    "validate:instructions": "node scripts/tasks.mjs validate:instructions",
     "build": "node scripts/tasks.mjs build",
     "copy:assets": "node scripts/tasks.mjs copy:assets",
     "prepare": "npm run build",

package/dist/instructions.md

@@ -1,169 +0,0 @@
-# MEMORY-MCP INSTRUCTIONS
-
-These instructions are available as a resource (`internal://instructions`) or prompt (`get-help`). Load them when unsure about tool usage.
-
----
-
-## CORE CAPABILITY
-
-- **Domain:** SQLite-backed persistent memory storage, full-text search, and graph recall for LLM agents.
-- **Primary Resources:** Memory entries (content + tags + metadata), directed labeled relationships between memories.
-- **Tools:**
-  - READ: `get_memory`, `search_memories`, `recall`, `retrieve_context`, `get_relationships`, `memory_stats`
-  - WRITE: `store_memory`, `store_memories`, `update_memory`, `delete_memory`, `delete_memories`, `create_relationship`, `delete_relationship`
-
----
-
-## PROMPTS
-
-- `get-help`: Returns these instructions for quick recall.
-
----
-
-## RESOURCES & RESOURCE LINKS
-
-- `internal://instructions`: This document.
-- `memory://memories/{hash}`: Retrieve a single memory by its SHA-256 hash (JSON). Supports hash auto-completion.
-
----
-
-## THE "GOLDEN PATH" WORKFLOWS (CRITICAL)
-
-### WORKFLOW A: STORE AND RETRIEVE
-
-1. Call `store_memory` with `content`, `tags`, and optional `importance`/`memory_type` to persist a memory. Note the returned `hash`.
-2. Call `get_memory` with `hash` to retrieve it later.
-3. For bulk ingestion, call `store_memories` with up to 50 items in one atomic transaction.
-   NOTE: Storing identical content+tags is idempotent — returns the existing hash with `created: false`.
-
-### WORKFLOW B: SEARCH AND DISCOVER
-
-1. Call `search_memories` with a `query` string to full-text search across content and tags.
-2. Use `cursor` from the response's `nextCursor` to paginate through results.
-3. Apply filters: `min_importance`, `max_importance`, `memory_type` to narrow results.
-   NOTE: Query terms are matched individually. FTS5 phrase operators and negation are **not** supported.
-
-### WORKFLOW C: GRAPH RECALL (BFS)
-
-1. Call `recall` with a `query` and `depth` (0–3) to search memories and traverse relationships via BFS.
-2. Inspect the returned `memories` (all discovered nodes) and `graph` (edges connecting them).
-3. Use `depth: 0` for search-only (no traversal), `depth: 1–3` for progressively wider graph exploration.
-   NOTE: If `aborted: true` is returned, the traversal hit a safety limit. Results are still valid but incomplete.
-
-### WORKFLOW D: CONTEXT WINDOW MANAGEMENT
-
-1. Call `retrieve_context` with a `query` and `token_budget` to get relevance-ranked memories that fit within a token limit.
-2. Choose `strategy`: `relevance` (FTS rank, default), `importance` (highest first), or `recency` (newest first).
-3. Check `truncated: true` to know if more memories matched but were excluded by the budget.
-   NOTE: Eliminates manual pagination and token counting. Use this when filling an LLM context window.
-
-### WORKFLOW E: BUILD KNOWLEDGE GRAPHS
-
-1. Call `store_memory` (or `store_memories`) to create memories and note their hashes.
-2. Call `create_relationship` with `from_hash`, `to_hash`, and `relation_type` to link them.
-3. Call `get_relationships` to inspect edges for a memory (filter by `direction`: outgoing, incoming, or both).
-4. Call `recall` with `depth: 1–3` to traverse the graph from a search query.
-   NOTE: Both endpoint memories must exist before creating a relationship.
-
----
-
-## TOOL NUANCES & GOTCHAS
-
-`store_memory`
-
-- Purpose: Store a single memory. Returns its SHA-256 hash.
-- Gotcha: Hash is deterministic — computed from `content` + sorted `tags`. Same content+tags always produces the same hash.
-- Gotcha: `importance` defaults to `0` if omitted. `memory_type` defaults to `general`.
-
-`store_memories`
-
-- Purpose: Batch store up to 50 memories in one atomic transaction.
-- Gotcha: If the transaction fails, all items roll back. Per-item results indicate `created: true/false`.
-
-`update_memory`
-
-- Purpose: Replace content (and optionally tags) of an existing memory. Returns old and new hashes.
-- Gotcha: The hash changes when content or tags change. Relationships automatically cascade to the new hash.
-- Gotcha: Returns `E_CONFLICT` if a memory already exists with the new content+tags combination.
-
-`search_memories`
-
-- Purpose: Full-text search over content and tags using SQLite FTS5.
-- Input: `limit` defaults to 20, max 100. `cursor` from previous `nextCursor` for pagination.
-- Gotcha: Only alphanumeric tokens are indexed. Special characters and FTS5 operators are stripped from queries.
-
-`recall`
-
-- Purpose: FTS search + BFS graph traversal up to 3 hops.
-- Input: `depth` defaults to 1, max 3. `limit` defaults to 10 (seed memories), max 50.
-- Gotcha: Traversal is bounded by frontier size (default 1,000), edge count (default 5,000), and visited nodes (default 5,000). Override via `RECALL_MAX_FRONTIER_SIZE`, `RECALL_MAX_EDGE_ROWS`, `RECALL_MAX_VISITED_NODES` env vars.
-
-`retrieve_context`
-
-- Purpose: Token-budgeted memory retrieval — fills a token budget with ranked results.
-- Input: `token_budget` defaults to 4,000, max 200,000. `strategy` defaults to `relevance`.
-- Gotcha: Token estimation uses ~4 characters per token. Internal candidate cap is 200 rows.
-
-`get_relationships`
-
-- Purpose: Retrieve all relationships for a memory with the linked memory content inlined.
-- Input: `direction` defaults to `both`. Options: `outgoing`, `incoming`, `both`.
-- Gotcha: Returns `E_NOT_FOUND` if the source memory does not exist.
-
-`create_relationship`
-
-- Purpose: Create a directed labeled edge between two memories.
-- Input: `relation_type` is free-form. Suggested types: `related_to`, `causes`, `depends_on`, `parent_of`, `child_of`, `supersedes`, `contradicts`, `supports`, `references`.
-- Gotcha: Idempotent — re-creating an existing relationship is a no-op. Both memories must exist.
-
-`delete_memory`
-
-- Purpose: Delete a single memory and all its relationships.
-- Side effects: Cascade-deletes all relationships involving this memory.
-
-`delete_memories`
-
-- Purpose: Batch delete up to 50 memories in one atomic transaction.
-- Side effects: Cascade-deletes all relationships involving deleted memories.
-
-`memory_stats`
-
-- Purpose: Return aggregate statistics (total counts, oldest/newest timestamps, average importance, breakdown by type).
-
----
-
-## CROSS-FEATURE RELATIONSHIPS
-
-- `store_memory` / `store_memories` produce hashes required by `get_memory`, `update_memory`, `delete_memory`, `create_relationship`, and `get_relationships`.
-- `search_memories` and `recall` share the same FTS5 index, query sanitization, and cursor pagination.
-- `recall` combines `search_memories`-style FTS seeding with BFS graph traversal from `get_relationships`-style edge queries.
-- `retrieve_context` uses the same FTS5 index but adds token budgeting and sort strategies on top.
-- `update_memory` changes a memory's hash — relationships cascade automatically via foreign keys.
-- `delete_memory` / `delete_memories` cascade-delete relationships via foreign keys.
-
----
-
-## CONSTRAINTS & LIMITATIONS
-
-- **Transport:** stdio only.
-- **Runtime:** Node.js >= 24 with FTS5-enabled SQLite.
-- **Database path:** Set via `MEMORY_DB_PATH` env var (default: `memory.db`).
-- **Content size:** Max 100,000 characters per memory.
-- **Tags:** 1–100 tags per memory, each max 50 characters, no whitespace.
-- **Importance:** Integer 0–10 (0 = lowest, 10 = critical).
-- **Memory types:** `general`, `fact`, `plan`, `decision`, `reflection`, `lesson`, `error`, `gradient`.
-- **Search limit:** Max 100 results per query (default 20).
-- **Recall depth:** Max 3 hops (default 1). Seed limit max 50 (default 10).
-- **Retrieve context budget:** Max 200,000 tokens (default 4,000). Internal candidate cap: 200 rows.
-- **Batch operations:** Max 50 items per `store_memories` / `delete_memories` call.
-- **BFS safety limits:** Configurable via `RECALL_MAX_FRONTIER_SIZE` (default 1,000), `RECALL_MAX_EDGE_ROWS` (default 5,000), `RECALL_MAX_VISITED_NODES` (default 5,000).
-
----
-
-## ERROR HANDLING STRATEGY
-
-- `E_NOT_FOUND`: Memory or relationship does not exist. → Call `search_memories` to find the correct hash, or verify the hash with `get_memory`.
-- `E_INVALID_CURSOR`: Pagination cursor is malformed or does not match the current query/filters. → Drop the cursor and restart pagination from the beginning.
-- `E_CONFLICT`: `update_memory` target content+tags already exists as another memory. → Call `get_memory` with the conflicting hash or choose different content/tags.
-- `E_DB_ERROR`: Database operation failed. → Check that the database file is accessible and not corrupted. Retry the operation.
-- `E_UNKNOWN`: Unexpected internal error. → Retry the operation. If persistent, inspect server logs.