@j0hanz/memory-mcp 1.0.1 → 1.1.0

package/dist/tools/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAIA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAsB;IAC7D,OAAO,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAsB;IAEtB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC;IACrC,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAIA,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAsB;IAC7D,OAAO,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,MAAsB;IAEtB,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAAC;IACrC,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,sBAAsB,CACpC,OAAgC,EAChC,GAAW;IAEX,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/dist/tools/retrieve-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-context.d.ts","sourceRoot":"","sources":["../../src/tools/retrieve-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAkH9C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAsG5E"}
+{"version":3,"file":"retrieve-context.d.ts","sourceRoot":"","sources":["../../src/tools/retrieve-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAMzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAoI9C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CA+G5E"}

package/dist/tools/retrieve-context.js

@@ -1,36 +1,39 @@
-import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
-import { E_UNKNOWN, getErrorMessage, rethrowMcpError } from '../lib/errors.js';
+import { McpError } from '@modelcontextprotocol/sdk/types.js';
+import { E_CANCELLED, E_UNKNOWN, getErrorMessage, rethrowMcpError, } from '../lib/errors.js';
 import { sanitizeFtsQuery } 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 { RetrieveContextInputSchema } from '../schemas/inputs.js';
-import { RetrieveContextResultSchema } from '../schemas/outputs.js';
+import {} from '../schemas/inputs.js';
+import {} from '../schemas/outputs.js';
 import { createProgressReporter, notifyProgress, progressWithMessage, } from './progress.js';
-import { getToolResultPayload, isOkStructuredToolResult } from './result.js';
-const RETRIEVE_CONTEXT_LIMIT = 200;
+import { countPayloadArrayItems, getToolResultPayload, isOkStructuredToolResult, } from './result.js';
+const MIN_CANDIDATE_ROWS = 200;
+const MAX_CANDIDATE_ROWS = 2000;
 const ESTIMATED_CHARS_PER_TOKEN = 4;
+// Assume average memory is ~20 tokens to set a reasonable upper bound for candidates
+const ESTIMATED_TOKENS_PER_MEMORY = 20;
 const RETRIEVE_CONTEXT_PROGRESS_MILESTONE = 25;
 const ORDER_BY_MAP = {
     importance: 'm.importance DESC, memories_fts.rank',
     recency: 'm.created_at DESC, memories_fts.rank',
     relevance: 'memories_fts.rank',
 };
-function countPayloadArrayItems(payload, key) {
-    const value = payload[key];
-    return Array.isArray(value) ? value.length : 0;
+function countPayloadMemories(payload) {
+    return countPayloadArrayItems(payload, 'memories');
 }
 function estimateTokens(content) {
     return Math.ceil(content.length / ESTIMATED_CHARS_PER_TOKEN);
 }
-function loadContextRows(db, query, orderBy) {
+function loadContextRows(db, query, orderBy, limit) {
     const ftsQuery = sanitizeFtsQuery(query);
     return db
         .prepareOnce(`SELECT m.*, memories_fts.rank AS rank FROM memories m
        JOIN memories_fts ON memories_fts.rowid = m.rowid
        WHERE memories_fts MATCH ?
        ORDER BY ${orderBy}
-       LIMIT ${RETRIEVE_CONTEXT_LIMIT + 1}`)
-        .all(ftsQuery);
+       LIMIT ?`)
+        .all(ftsQuery, limit + 1);
 }
 function reportSelectionProgress(onProgress, current, total, force = false) {
     if (!onProgress || current === 0) {
@@ -42,6 +45,12 @@ function reportSelectionProgress(onProgress, current, total, force = false) {
     onProgress({ current, total });
 }
 function formatCompletionMessage(query, result) {
+    if (result.structuredContent?.error) {
+        const error = result.structuredContent.error;
+        if (error.code === E_CANCELLED) {
+            return `⊙ retrieve_context: ${query} • cancelled`;
+        }
+    }
     const failedMessage = `⊙ retrieve_context: ${query} • failed`;
     if (result.isError) {
         return failedMessage;
@@ -53,7 +62,7 @@ function formatCompletionMessage(query, result) {
     if (!payload) {
         return `⊙ retrieve_context: ${query} • completed`;
     }
-    const memoriesCount = countPayloadArrayItems(payload, 'memories');
+    const memoriesCount = countPayloadMemories(payload);
     const estimatedTokens = 'estimated_tokens' in payload &&
         typeof payload.estimated_tokens === 'number'
         ? payload.estimated_tokens
@@ -65,20 +74,24 @@ function throwIfAborted(signal) {
     if (!signal?.aborted) {
         return;
     }
-    throw new McpError(ErrorCode.RequestTimeout, 'Request cancelled');
+    throw new Error(E_CANCELLED);
 }
 export function registerRetrieveContext(server, db) {
-    server.registerTool('retrieve_context', {
-        title: 'Retrieve Context',
-        description: 'Search memories and return relevance-ranked results that fit within a caller-specified token budget. Eliminates manual pagination and token counting for context window management.',
-        inputSchema: RetrieveContextInputSchema,
-        outputSchema: RetrieveContextResultSchema,
-        annotations: { readOnlyHint: true, openWorldHint: false },
+    const contract = getToolContract('retrieve_context');
+    server.registerTool(contract.name, {
+        title: contract.title,
+        description: contract.description,
+        inputSchema: contract.inputSchema,
+        outputSchema: contract.outputSchema,
+        annotations: contract.annotations,
     }, async (params, extra) => {
         const { query, strategy } = params;
         const tokenBudget = params.token_budget;
         const contextLabel = `⊙ retrieve_context: ${query} [${strategy}]`;
         let completionCurrent = 1;
+        // Heuristic: Load enough candidates to likely fill the budget, but cap to avoid massive queries
+        const estimatedCandidates = Math.ceil(tokenBudget / ESTIMATED_TOKENS_PER_MEMORY);
+        const limit = Math.min(Math.max(MIN_CANDIDATE_ROWS, estimatedCandidates), MAX_CANDIDATE_ROWS);
         await notifyProgress(extra, {
             current: 0,
             message: `${contextLabel} [budget ${tokenBudget}]`,
@@ -89,11 +102,9 @@ export function registerRetrieveContext(server, db) {
         try {
             throwIfAborted(extra.signal);
             const orderBy = ORDER_BY_MAP[strategy];
-            const rows = loadContextRows(db, query, orderBy);
-            const rowCapExceeded = rows.length > RETRIEVE_CONTEXT_LIMIT;
-            const candidateCount = rowCapExceeded
-                ? RETRIEVE_CONTEXT_LIMIT
-                : rows.length;
+            const rows = loadContextRows(db, query, orderBy, limit);
+            const rowCapExceeded = rows.length > limit;
+            const candidateCount = rowCapExceeded ? limit : rows.length;
             completionCurrent = candidateCount + 1;
             let estimatedTokens = 0;
             let truncated = rowCapExceeded;
@@ -124,7 +135,10 @@ export function registerRetrieveContext(server, db) {
             });
         }
         catch (err) {
-            if (err instanceof McpError) {
+            if (err instanceof Error && err.message === E_CANCELLED) {
+                result = createErrorResponse(E_CANCELLED, 'Request cancelled');
+            }
+            else if (err instanceof McpError) {
                 thrownError = err;
             }
             else {

package/dist/tools/retrieve-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"retrieve-context.js","sourceRoot":"","sources":["../../src/tools/retrieve-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"retrieve-context.js","sourceRoot":"","sources":["../../src/tools/retrieve-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAK9D,OAAO,EACL,WAAW,EACX,SAAS,EACT,eAAe,EACf,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAmC,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAoC,MAAM,uBAAuB,CAAC;AACzE,OAAO,EACL,sBAAsB,EACtB,cAAc,EACd,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,aAAa,CAAC;AAKrB,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAChC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AACpC,qFAAqF;AACrF,MAAM,2BAA2B,GAAG,EAAE,CAAC;AAEvC,MAAM,mCAAmC,GAAG,EAAE,CAAC;AAE/C,MAAM,YAAY,GAAG;IACnB,UAAU,EAAE,sCAAsC;IAClD,OAAO,EAAE,sCAAsC;IAC/C,SAAS,EAAE,mBAAmB;CACoB,CAAC;AAErD,SAAS,oBAAoB,CAAC,OAAgC;IAC5D,OAAO,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,yBAAyB,CAAC,CAAC;AAC/D,CAAC;AAED,SAAS,eAAe,CACtB,EAAW,EACX,KAAa,EACb,OAAe,EACf,KAAa;IAEb,MAAM,QAAQ,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,EAAE;SACN,WAAW,CACV;;;kBAGY,OAAO;eACV,CACV;SACA,GAAG,CAAC,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,uBAAuB,CAC9B,UAEa,EACb,OAAe,EACf,KAAa,EACb,KAAK,GAAG,KAAK;IAEb,IAAI,CAAC,UAAU,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO;IACT,CAAC;IACD,IAAI,CAAC,KAAK,IAAI,OAAO,GAAG,mCAAmC,KAAK,CAAC,EAAE,CAAC;QAClE,OAAO;IACT,CAAC;IACD,UAAU,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,uBAAuB,CAC9B,KAAa,EACb,MAAsB;IAEtB,IAAI,MAAM,CAAC,iBAAiB,EAAE,KAAK,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,iBAAiB,CAAC,KAA0B,CAAC;QAClE,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC/B,OAAO,uBAAuB,KAAK,cAAc,CAAC;QACpD,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,uBAAuB,KAAK,WAAW,CAAC;IAC9D,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,uBAAuB,KAAK,cAAc,CAAC;IACpD,CAAC;IAED,MAAM,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IACpD,MAAM,eAAe,GACnB,kBAAkB,IAAI,OAAO;QAC7B,OAAO,OAAO,CAAC,gBAAgB,KAAK,QAAQ;QAC1C,CAAC,CAAC,OAAO,CAAC,gBAAgB;QAC1B,CAAC,CAAC,CAAC,CAAC;IACR,MAAM,SAAS,GACb,WAAW,IAAI,OAAO,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7E,OAAO,uBAAuB,KAAK,MAAM,aAAa,cAAc,eAAe,UAAU,SAAS,EAAE,CAAC;AAC3G,CAAC;AAED,SAAS,cAAc,CAAC,MAAoB;IAC1C,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAiB,EAAE,EAAW;IACpE,MAAM,QAAQ,GAAG,eAAe,CAAC,kBAAkB,CAAC,CAAC;IACrD,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,WAAgD;QACtE,YAAY,EAAE,QAAQ,CAAC,YAAkD;QACzE,WAAW,EAAE,QAAQ,CAAC,WAAW;KAClC,EACD,KAAK,EAAE,MAA4B,EAAE,KAAK,EAAE,EAAE;QAC5C,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QACnC,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,CAAC;QACxC,MAAM,YAAY,GAAG,uBAAuB,KAAK,KAAK,QAAQ,GAAG,CAAC;QAClE,IAAI,iBAAiB,GAAG,CAAC,CAAC;QAE1B,gGAAgG;QAChG,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CACnC,WAAW,GAAG,2BAA2B,CAC1C,CAAC;QACF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CACpB,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,EACjD,kBAAkB,CACnB,CAAC;QAEF,MAAM,cAAc,CAAC,KAAK,EAAE;YAC1B,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,GAAG,YAAY,YAAY,WAAW,GAAG;SACnD,CAAC,CAAC;QAEH,MAAM,YAAY,GAAG,mBAAmB,CACtC,sBAAsB,CAAC,KAAK,CAAC,EAC7B,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CACrB,GAAG,YAAY,UAAU,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,GAAG,CACnF,CAAC;QAEF,IAAI,MAAkC,CAAC;QACvC,IAAI,WAAiC,CAAC;QACtC,IAAI,CAAC;YACH,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC7B,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvC,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACxD,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;YAC3C,MAAM,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5D,iBAAiB,GAAG,cAAc,GAAG,CAAC,CAAC;YAEvC,IAAI,eAAe,GAAG,CAAC,CAAC;YACxB,IAAI,SAAS,GAAG,cAAc,CAAC;YAC/B,MAAM,QAAQ,GAAa,EAAE,CAAC;YAC9B,IAAI,OAAO,GAAG,CAAC,CAAC;YAEhB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3C,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;gBACpB,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBACtB,MAAM;gBACR,CAAC;gBACD,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;gBAChC,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC3C,OAAO,IAAI,CAAC,CAAC;gBACb,uBAAuB,CACrB,YAAY,EACZ,OAAO,EACP,iBAAiB,EACjB,KAAK,CACN,CAAC;gBACF,IAAI,eAAe,GAAG,MAAM,GAAG,WAAW,EAAE,CAAC;oBAC3C,SAAS,GAAG,IAAI,CAAC;oBACjB,MAAM;gBACR,CAAC;gBACD,eAAe,IAAI,MAAM,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YAED,uBAAuB,CAAC,YAAY,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;YAExE,MAAM,GAAG,kBAAkB,CAAC;gBAC1B,QAAQ,EAAE,QAAQ;gBAClB,gBAAgB,EAAE,eAAe;gBACjC,SAAS;aACV,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;gBACxD,MAAM,GAAG,mBAAmB,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;YACjE,CAAC;iBAAM,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;gBACnC,WAAW,GAAG,GAAG,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,eAAe,CAAC,GAAG,CAAC,CAAC;gBACrB,MAAM,GAAG,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;QAED,MAAM,YAAY,CAAC,KAAK,EAAE,CAAC;QAE3B,MAAM,gBAAgB,GACpB,MAAM,IAAI,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;QAEzE,MAAM,cAAc,CAAC,KAAK,EAAE;YAC1B,OAAO,EAAE,iBAAiB;YAC1B,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE,uBAAuB,CAAC,KAAK,EAAE,gBAAgB,CAAC;SAC1D,CAAC,CAAC;QAEH,IAAI,WAAW,EAAE,CAAC;YAChB,MAAM,WAAW,CAAC;QACpB,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"search-memories.d.ts","sourceRoot":"","sources":["../../src/tools/search-memories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAqB9C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAuD3E"}
+{"version":3,"file":"search-memories.d.ts","sourceRoot":"","sources":["../../src/tools/search-memories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAsB9C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAuD3E"}

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":"AAKA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAIhD,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,EAAW;IACnE,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,kNAAkN;QACpN,WAAW,EAAE,yBAAyB;QACtC,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,eAAe,CACb,CAAC,MAAmB,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;YACjC,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,KAAK,GAAG,sBAAsB,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC5D,MAAM,aAAa,GAAG,MAAM;gBAC1B,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE,KAAK,CAAC;gBACnC,CAAC,CAAC,SAAS,CAAC;YACd,MAAM,IAAI,GAAG,oBAAoB,CAC/B,EAAE,EACF,MAAM,CAAC,KAAK,EACZ,KAAK,EACL,aAAa,EACb,OAAO,CACR,CAAC;YACF,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAE3D,MAAM,QAAQ,GAAa,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACxD,IAAI,UAA8B,CAAC;YACnC,IAAI,OAAO,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;gBAC9C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;oBAC1B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;oBAC/B,UAAU,GAAG,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;YAED,OAAO,kBAAkB,CAAC;gBACxB,QAAQ;gBACR,cAAc,EAAE,QAAQ,CAAC,MAAM;gBAC/B,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtC,CAAC,CAAC;QACL,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,MAAmB,EAAE,EAAE,CACvC,sBAAsB,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,KAAK,GAAG;KAC/D,CACF,CACF,CAAC;AACJ,CAAC"}
+{"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.1.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",