@j0hanz/memory-mcp 1.5.0 → 1.6.0

package/dist/completions/index.d.ts

@@ -1,2 +1,3 @@
 import type { TypedDb } from '../db/typed.js';
 export declare function createHashCompletionCallback(db: TypedDb): (value: string) => string[];
+//# sourceMappingURL=index.d.ts.map

package/dist/completions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/completions/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAoB9C,wBAAgB,4BAA4B,CAC1C,EAAE,EAAE,OAAO,GACV,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAO7B"}

package/dist/db/index.d.ts

@@ -2,3 +2,4 @@ import { DatabaseSync } from 'node:sqlite';
 import { type TypedDb } from './typed.js';
 export declare function initDatabase(path: string): DatabaseSync;
 export declare function initTypedDatabase(path: string): TypedDb;
+//# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AA6LzD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAWvD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGvD"}

package/dist/db/index.js

@@ -63,6 +63,14 @@ const SCHEMA_SQL = `
   CREATE INDEX IF NOT EXISTS idx_relationships_to
     ON relationships(to_hash);
 `;
+const RELATIONSHIP_EDGE_COLUMNS = new Set(['from_hash', 'to_hash']);
+function isMemoryRelationshipForeignKey(row) {
+    return row.table === 'memories' && RELATIONSHIP_EDGE_COLUMNS.has(row.from);
+}
+function ensureRelationshipIndexes(db) {
+    db.exec('CREATE INDEX IF NOT EXISTS idx_relationships_from ON relationships(from_hash)');
+    db.exec('CREATE INDEX IF NOT EXISTS idx_relationships_to ON relationships(to_hash)');
+}
 function runImmediateTransaction(db, action) {
     db.exec('BEGIN IMMEDIATE');
     try {
@@ -101,13 +109,8 @@ function needsRelationshipsCascadeUpdateMigration(db) {
     const rows = db
         .prepare("PRAGMA foreign_key_list('relationships')")
         .all();
-    if (rows.length === 0) {
-        return false;
-    }
     for (const row of rows) {
-        const isMemoryEdge = row.table === 'memories' &&
-            (row.from === 'from_hash' || row.from === 'to_hash');
-        if (!isMemoryEdge) {
+        if (!isMemoryRelationshipForeignKey(row)) {
             continue;
         }
         if (row.on_update.toUpperCase() !== 'CASCADE') {
@@ -126,8 +129,7 @@ function migrateRelationshipsCascadeUpdate(db) {
       FROM relationships_old
     `);
         db.exec('DROP TABLE relationships_old');
-        db.exec('CREATE INDEX IF NOT EXISTS idx_relationships_from ON relationships(from_hash)');
-        db.exec('CREATE INDEX IF NOT EXISTS idx_relationships_to ON relationships(to_hash)');
+        ensureRelationshipIndexes(db);
     });
 }
 function applyMigrations(db) {

package/dist/db/typed.d.ts

@@ -18,3 +18,4 @@ export declare class TypedDb {
 }
 export declare function createTypedDb(db: DatabaseSync): TypedDb;
 export {};
+//# sourceMappingURL=typed.d.ts.map

package/dist/db/typed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed.d.ts","sourceRoot":"","sources":["../../src/db/typed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,yBAAyB,EAC1B,MAAM,aAAa,CAAC;AAErB,KAAK,SAAS,GAAG,SAAS,aAAa,EAAE,CAAC;AAE1C,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,GAAG,CAAC,GAAG,MAAM,EAAE,SAAS,GAAG,CAAC,EAAE,CAAC;IAC/B,GAAG,CAAC,GAAG,MAAM,EAAE,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC;IACzC,GAAG,CAAC,GAAG,MAAM,EAAE,SAAS,GAAG,yBAAyB,CAAC;CACtD;AAED,qBAAa,OAAO;IAGN,OAAO,CAAC,QAAQ,CAAC,EAAE;IAF/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA8C;gBAEvC,EAAE,EAAE,YAAY;IAE7C,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;IAI1C,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;IAU9C,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;IAYlC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB,KAAK,IAAI,IAAI;CAId;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAEvD"}

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 #!/usr/bin/env node
 export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/lib/errors.d.ts

@@ -8,3 +8,4 @@ export declare const E_UNKNOWN = "E_UNKNOWN";
 export declare function getErrorMessage(err: unknown): string;
 export declare function isMcpError(err: unknown): err is McpError;
 export declare function rethrowMcpError(err: unknown): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,UAAU,eAAe,CAAC;AACvC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,SAAS,cAAc,CAAC;AAGrC,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAIpD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,QAAQ,CAExD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAElD"}

package/dist/lib/hash.d.ts

@@ -1 +1,2 @@
 export declare function computeMemoryHash(content: string, tags: readonly string[]): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/lib/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/lib/hash.ts"],"names":[],"mappings":"AAiBA,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,MAAM,CAKR"}

package/dist/lib/instructions.d.ts

@@ -1 +1,2 @@
 export declare function loadInstructions(): string;
+//# sourceMappingURL=instructions.d.ts.map

package/dist/lib/instructions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instructions.d.ts","sourceRoot":"","sources":["../../src/lib/instructions.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,IAAI,MAAM,CAGzC"}

package/dist/lib/json-schema.d.ts

@@ -1,3 +1,4 @@
 import { z } from 'zod/v4';
 export type JsonSchemaObject = Record<string, unknown>;
 export declare function extractJsonSchema(schema: z.ZodType): JsonSchemaObject;
+//# sourceMappingURL=json-schema.d.ts.map

package/dist/lib/json-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.d.ts","sourceRoot":"","sources":["../../src/lib/json-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAE3B,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEvD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,gBAAgB,CAMrE"}

package/dist/lib/mcp-utils.d.ts

@@ -3,3 +3,4 @@ type LogLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error';
 export declare function logToolEvent(server: McpServer, logger: string, data: unknown, level?: LogLevel): Promise<void>;
 export declare function notifyMemoryResourceUpdated(server: McpServer, hash: string): Promise<void>;
 export {};
+//# sourceMappingURL=mcp-utils.d.ts.map

package/dist/lib/mcp-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-utils.d.ts","sourceRoot":"","sources":["../../src/lib/mcp-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,KAAK,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;AAOlE,wBAAsB,YAAY,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EACb,KAAK,GAAE,QAAiB,GACvB,OAAO,CAAC,IAAI,CAAC,CAUf;AAID,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/lib/pagination.d.ts

@@ -5,3 +5,4 @@ export interface PageSlice<T> {
 export declare function encodeCursor(offset: number): string;
 export declare function decodeCursor(cursor: string): number;
 export declare function splitPage<T>(rows: readonly T[], limit: number): PageSlice<T>;
+//# sourceMappingURL=pagination.d.ts.map

package/dist/lib/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/lib/pagination.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,EAAE,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;CAClB;AAwCD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMnD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,CAM5E"}

package/dist/lib/search-cursor.d.ts

@@ -10,3 +10,4 @@ export type DecodedSearchCursor = {
 export declare function buildSearchCursorScope(query: string, filters: MemoryFilters): string;
 export declare function encodeSearchCursor(scope: string, rank: number, hash: string): string;
 export declare function decodeSearchCursor(cursor: string, expectedScope: string): DecodedSearchCursor;
+//# sourceMappingURL=search-cursor.d.ts.map

package/dist/lib/search-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-cursor.d.ts","sourceRoot":"","sources":["../../src/lib/search-cursor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAoBjD,MAAM,MAAM,mBAAmB,GAC3B;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA+DN,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,aAAa,GACrB,MAAM,CAKR;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM,CASR;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,mBAAmB,CAuBrB"}

package/dist/lib/search.d.ts

@@ -27,3 +27,4 @@ export declare function toMemoryFilters(params: {
     max_importance?: number | undefined;
     memory_type?: string | undefined;
 }): MemoryFilters;
+//# sourceMappingURL=search.d.ts.map

package/dist/lib/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/lib/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAW5C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOtD;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAOD,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB,GACD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAWN,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAaxE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAMtE;AAsDD,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,OAAO,EACX,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,iBAAiB,GAAG,SAAS,EACrC,OAAO,EAAE,aAAa,GACrB,SAAS,EAAE,CAIb;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE;IACtC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,GAAG,aAAa,CAUhB"}

package/dist/lib/search.js

@@ -35,15 +35,18 @@ export function buildAndWhereClause(clauses) {
     }
     return ` AND ${clauses.join(' AND ')}`;
 }
+function buildBaseSearchWhere(whereExtra) {
+    return `${BASE_RANKED_SEARCH_SQL}
+         WHERE memories_fts MATCH ?${whereExtra}`;
+}
 function buildRankedSearchSql(whereExtra, cursor) {
+    const whereSql = buildBaseSearchWhere(whereExtra);
     if (!cursor || cursor.mode === 'offset') {
-        return `${BASE_RANKED_SEARCH_SQL}
-         WHERE memories_fts MATCH ?${whereExtra}
+        return `${whereSql}
          ORDER BY memories_fts.rank, m.hash
          LIMIT ? OFFSET ?`;
     }
-    return `${BASE_RANKED_SEARCH_SQL}
-       WHERE memories_fts MATCH ?${whereExtra}
+    return `${whereSql}
          AND (
            memories_fts.rank > ?
            OR (memories_fts.rank = ? AND m.hash > ?)
@@ -51,28 +54,33 @@ function buildRankedSearchSql(whereExtra, cursor) {
        ORDER BY memories_fts.rank, m.hash
        LIMIT ?`;
 }
-export function loadRankedSearchRows(db, query, limit, cursor, filters) {
-    const ftsQuery = sanitizeFtsQuery(query);
-    const filter = buildFilterClauses(filters);
-    const whereExtra = buildAndWhereClause(filter.clauses);
-    const sql = buildRankedSearchSql(whereExtra, cursor);
-    const stmt = db.prepareOnce(sql);
+function buildRankedSearchParams(ftsQuery, filterParams, limit, cursor) {
+    const baseParams = [ftsQuery, ...filterParams];
     if (!cursor || cursor.mode === 'offset') {
         const offset = cursor?.offset ?? 0;
-        return stmt.all(ftsQuery, ...filter.params, limit + 1, offset);
+        return [...baseParams, limit + 1, offset];
     }
-    return stmt.all(ftsQuery, ...filter.params, cursor.rank, cursor.rank, cursor.hash, limit + 1);
+    return [...baseParams, cursor.rank, cursor.rank, cursor.hash, limit + 1];
+}
+function buildSearchPlan(query, limit, cursor, filters) {
+    const filter = buildFilterClauses(filters);
+    const sql = buildRankedSearchSql(buildAndWhereClause(filter.clauses), cursor);
+    const params = buildRankedSearchParams(query, filter.params, limit, cursor);
+    return { sql, params };
+}
+export function loadRankedSearchRows(db, query, limit, cursor, filters) {
+    const ftsQuery = sanitizeFtsQuery(query);
+    const plan = buildSearchPlan(ftsQuery, limit, cursor, filters);
+    return db.prepareOnce(plan.sql).all(...plan.params);
 }
 export function toMemoryFilters(params) {
-    const filters = {};
-    if (params.min_importance != null) {
-        filters.min_importance = params.min_importance;
-    }
-    if (params.max_importance != null) {
-        filters.max_importance = params.max_importance;
-    }
-    if (params.memory_type != null) {
-        filters.memory_type = params.memory_type;
-    }
-    return filters;
+    return {
+        ...(params.min_importance != null
+            ? { min_importance: params.min_importance }
+            : {}),
+        ...(params.max_importance != null
+            ? { max_importance: params.max_importance }
+            : {}),
+        ...(params.memory_type != null ? { memory_type: params.memory_type } : {}),
+    };
 }

package/dist/lib/sql.d.ts

@@ -14,3 +14,4 @@ export declare const MEMORY_AGGREGATE_SQL = "SELECT COUNT(*) AS total,\n
 export declare const RELATIONSHIP_COUNT_SQL = "SELECT COUNT(*) AS total FROM relationships";
 /** Per-type memory breakdown. */
 export declare const TYPE_COUNTS_SQL = "SELECT memory_type, COUNT(*) AS count FROM memories GROUP BY memory_type ORDER BY count DESC";
+//# sourceMappingURL=sql.d.ts.map

package/dist/lib/sql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.d.ts","sourceRoot":"","sources":["../../src/lib/sql.ts"],"names":[],"mappings":"AAAA;mDACmD;AAEnD,8EAA8E;AAC9E,eAAO,MAAM,iBAAiB,0IACC,CAAC;AAEhC,mEAAmE;AACnE,eAAO,MAAM,iBAAiB,wCAAwC,CAAC;AAEvE,uCAAuC;AACvC,eAAO,MAAM,yBAAyB,0CACG,CAAC;AAE1C,+EAA+E;AAC/E,eAAO,MAAM,sBAAsB,6CACS,CAAC;AAE7C,qDAAqD;AACrD,eAAO,MAAM,oBAAoB,yKAIhB,CAAC;AAElB,gCAAgC;AAChC,eAAO,MAAM,sBAAsB,gDACY,CAAC;AAEhD,iCAAiC;AACjC,eAAO,MAAM,eAAe,iGACoE,CAAC"}

package/dist/lib/tool-contracts.d.ts

@@ -15,3 +15,4 @@ export interface ToolContract {
 export declare const TOOL_CONTRACTS: ToolContract[];
 export declare function getToolContracts(): ToolContract[];
 export declare function getToolContract(name: string): ToolContract;
+//# sourceMappingURL=tool-contracts.d.ts.map

package/dist/lib/tool-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-contracts.d.ts","sourceRoot":"","sources":["../../src/lib/tool-contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,QAAQ,CAAC;AAgChC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IACvB,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC;IACxB,WAAW,EAAE;QACX,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,CAAC;CACH;AAsCD,eAAO,MAAM,cAAc,EAAE,YAAY,EAuHxC,CAAC;AAMF,wBAAgB,gBAAgB,IAAI,YAAY,EAAE,CAEjD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAM1D"}

package/dist/lib/tool-contracts.js

@@ -1,167 +1,139 @@
 import {} from 'zod/v4';
 import { CreateRelationshipInputSchema, DeleteMemoriesInputSchema, DeleteMemoryInputSchema, DeleteRelationshipInputSchema, GetMemoryInputSchema, GetRelationshipsInputSchema, MemoryStatsInputSchema, RecallInputSchema, RetrieveContextInputSchema, SearchMemoriesInputSchema, StoreMemoriesInputSchema, StoreMemoryInputSchema, UpdateMemoryInputSchema, } from '../schemas/inputs.js';
 import { BatchResultSchema, CreateRelationshipResultSchema, DeleteRelationshipResultSchema, DeleteResultSchema, MemoryResultSchema, RecallResultSchema, RelationshipResultSchema, RetrieveContextResultSchema, SearchResultSchema, StatsResultSchema, StoreResultSchema, UpdateResultSchema, } from '../schemas/outputs.js';
+const DEFAULT_ANNOTATIONS = {
+    readOnlyHint: false,
+    idempotentHint: false,
+    destructiveHint: false,
+    openWorldHint: false,
+};
+const READ_ONLY_ANNOTATIONS = {
+    readOnlyHint: true,
+};
+const IDEMPOTENT_ANNOTATIONS = {
+    idempotentHint: true,
+};
+const DESTRUCTIVE_ANNOTATIONS = {
+    destructiveHint: true,
+};
+function createToolContract(definition) {
+    const { annotations, ...rest } = definition;
+    return {
+        ...rest,
+        annotations: {
+            ...DEFAULT_ANNOTATIONS,
+            ...annotations,
+        },
+    };
+}
 export const TOOL_CONTRACTS = [
-    {
+    createToolContract({
         name: 'store_memory',
         title: 'Store Memory',
         description: 'Store single memory. Returns hash. Idempotent (created: false if exists). Prefer store_memories.',
         inputSchema: StoreMemoryInputSchema,
         outputSchema: StoreResultSchema,
-        annotations: {
-            readOnlyHint: false,
-            idempotentHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
+        annotations: IDEMPOTENT_ANNOTATIONS,
+    }),
+    createToolContract({
         name: 'store_memories',
         title: 'Store Memories (Batch)',
         description: 'Store 1-50 memories atomically. Idempotent. Rolls back on error.',
         inputSchema: StoreMemoriesInputSchema,
         outputSchema: BatchResultSchema,
-        annotations: {
-            readOnlyHint: false,
-            idempotentHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
+        annotations: IDEMPOTENT_ANNOTATIONS,
+    }),
+    createToolContract({
         name: 'get_memory',
         title: 'Get Memory',
         description: 'Retrieve memory by SHA-256 hash. Returns E_NOT_FOUND if missing.',
         inputSchema: GetMemoryInputSchema,
         outputSchema: MemoryResultSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
+        annotations: READ_ONLY_ANNOTATIONS,
+    }),
+    createToolContract({
         name: 'search_memories',
         title: 'Search Memories',
         description: 'Full-text search (content+tags). Ranked, paginated. Alphanumeric/underscore only. Implicit AND.',
         inputSchema: SearchMemoriesInputSchema,
         outputSchema: SearchResultSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
+        annotations: READ_ONLY_ANNOTATIONS,
+    }),
+    createToolContract({
         name: 'retrieve_context',
         title: 'Retrieve Context',
         description: 'FTS search within token budget. Sorts by relevance/importance/recency. Returns truncated: true if limit hit.',
         inputSchema: RetrieveContextInputSchema,
         outputSchema: RetrieveContextResultSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
+        annotations: READ_ONLY_ANNOTATIONS,
+    }),
+    createToolContract({
         name: 'recall',
         title: 'Recall (BFS Graph Traversal)',
         description: 'FTS search + BFS traversal (depth hops). Returns memories+edges. Emits progress. Aborts on limit.',
         inputSchema: RecallInputSchema,
         outputSchema: RecallResultSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
+        annotations: READ_ONLY_ANNOTATIONS,
+    }),
+    createToolContract({
         name: 'update_memory',
         title: 'Update Memory',
         description: 'Update content/tags. Returns old+new hash. Cascade updates relationships.',
         inputSchema: UpdateMemoryInputSchema,
         outputSchema: UpdateResultSchema,
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
+        annotations: DESTRUCTIVE_ANNOTATIONS,
+    }),
+    createToolContract({
         name: 'delete_memory',
         title: 'Delete Memory',
         description: 'Delete memory by hash. Cascade deletes relationships. Idempotent.',
         inputSchema: DeleteMemoryInputSchema,
         outputSchema: DeleteResultSchema,
         annotations: {
-            readOnlyHint: false,
-            idempotentHint: true,
-            destructiveHint: true,
-            openWorldHint: false,
+            ...DESTRUCTIVE_ANNOTATIONS,
+            ...IDEMPOTENT_ANNOTATIONS,
         },
-    },
-    {
+    }),
+    createToolContract({
         name: 'delete_memories',
         title: 'Delete Memories (Batch)',
         description: 'Delete 1-50 memories atomically. Cascade deletes. Rolls back on error.',
         inputSchema: DeleteMemoriesInputSchema,
         outputSchema: BatchResultSchema,
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
+        annotations: DESTRUCTIVE_ANNOTATIONS,
+    }),
+    createToolContract({
         name: 'create_relationship',
         title: 'Create Relationship',
         description: 'Create directed edge. Idempotent. Errors if endpoints missing.',
         inputSchema: CreateRelationshipInputSchema,
         outputSchema: CreateRelationshipResultSchema,
-        annotations: {
-            readOnlyHint: false,
-            idempotentHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
+        annotations: IDEMPOTENT_ANNOTATIONS,
+    }),
+    createToolContract({
         name: 'delete_relationship',
         title: 'Delete Relationship',
         description: 'Delete edge. Exact match required. Errors if missing.',
         inputSchema: DeleteRelationshipInputSchema,
         outputSchema: DeleteRelationshipResultSchema,
-        annotations: {
-            readOnlyHint: false,
-            destructiveHint: true,
-            openWorldHint: false,
-        },
-    },
-    {
+        annotations: DESTRUCTIVE_ANNOTATIONS,
+    }),
+    createToolContract({
         name: 'get_relationships',
         title: 'Get Relationships',
         description: 'Get relationships for memory. Filter direction. Inlines related memory.',
         inputSchema: GetRelationshipsInputSchema,
         outputSchema: RelationshipResultSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    },
-    {
+        annotations: READ_ONLY_ANNOTATIONS,
+    }),
+    createToolContract({
         name: 'memory_stats',
         title: 'Memory Stats',
         description: 'Get global stats: counts, timestamps, importance.',
         inputSchema: MemoryStatsInputSchema,
         outputSchema: StatsResultSchema,
-        annotations: {
-            readOnlyHint: true,
-            destructiveHint: false,
-            openWorldHint: false,
-        },
-    },
+        annotations: READ_ONLY_ANNOTATIONS,
+    }),
 ];
 const TOOL_CONTRACTS_BY_NAME = new Map(TOOL_CONTRACTS.map((contract) => [contract.name, contract]));
 export function getToolContracts() {

package/dist/lib/tool-execution.d.ts

@@ -0,0 +1,13 @@
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+interface BatchSummary {
+    succeeded: number;
+    failed: number;
+    matched: number;
+}
+interface BatchItemLike {
+    ok: boolean;
+}
+export declare function executeToolSafely(work: () => Promise<CallToolResult> | CallToolResult): Promise<CallToolResult>;
+export declare function summarizeBatch<T extends BatchItemLike>(items: readonly T[], isMatched: (item: T) => boolean): BatchSummary;
+export {};
+//# sourceMappingURL=tool-execution.d.ts.map

package/dist/lib/tool-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-execution.d.ts","sourceRoot":"","sources":["../../src/lib/tool-execution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAKzE,UAAU,YAAY;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,aAAa;IACrB,EAAE,EAAE,OAAO,CAAC;CACb;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,GACnD,OAAO,CAAC,cAAc,CAAC,CAOzB;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,aAAa,EACpD,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAC9B,YAAY,CAkBd"}

package/dist/lib/tool-execution.js

@@ -0,0 +1,28 @@
+import { E_UNKNOWN, getErrorMessage, rethrowMcpError } from './errors.js';
+import { createErrorResponse } from './tool-response.js';
+export async function executeToolSafely(work) {
+    try {
+        return await work();
+    }
+    catch (err) {
+        rethrowMcpError(err);
+        return createErrorResponse(E_UNKNOWN, getErrorMessage(err));
+    }
+}
+export function summarizeBatch(items, isMatched) {
+    let succeeded = 0;
+    let matched = 0;
+    for (const item of items) {
+        if (item.ok) {
+            succeeded += 1;
+        }
+        if (isMatched(item)) {
+            matched += 1;
+        }
+    }
+    return {
+        succeeded,
+        failed: items.length - succeeded,
+        matched,
+    };
+}

package/dist/lib/tool-response.d.ts

@@ -1,3 +1,4 @@
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
 export declare function createToolResponse(payload: Record<string, unknown>): CallToolResult;
 export declare function createErrorResponse(code: string, message: string): CallToolResult;
+//# sourceMappingURL=tool-response.d.ts.map

package/dist/lib/tool-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-response.d.ts","sourceRoot":"","sources":["../../src/lib/tool-response.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAyBzE,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,cAAc,CAMhB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,cAAc,CAMhB"}

package/dist/lib/types.d.ts

@@ -72,3 +72,4 @@ export interface HashRow {
 }
 export declare function parseTags(tagsJson: string): string[];
 export declare function parseMemoryRow(row: MemoryRow): Memory;
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,YAAY,EACZ,WAAW,GAAG,SAAS,GAAG,eAAe,CAC1C,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;CACd;AAQD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAOpD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,GAAG,MAAM,CAarD"}

package/dist/prompts/index.d.ts

@@ -1,2 +1,3 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerAllPrompts(server: McpServer): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/prompts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsCzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAS1D"}

package/dist/prompts/index.js

@@ -1,5 +1,10 @@
 import { loadInstructions } from '../lib/instructions.js';
 const INSTRUCTIONS_CONTENT = loadInstructions();
+const GET_HELP_PROMPT = {
+    name: 'get-help',
+    title: 'Get Help',
+    description: 'Return full usage instructions.',
+};
 function createHelpMessages(instructions) {
     return [
         {
@@ -19,13 +24,12 @@ function createHelpMessages(instructions) {
     ];
 }
 const HELP_MESSAGES = createHelpMessages(INSTRUCTIONS_CONTENT);
-const GET_HELP_PROMPT_NAME = 'get-help';
-const GET_HELP_PROMPT_CONFIG = {
-    title: 'Get Help',
-    description: 'Return full usage instructions.',
-};
+function createGetHelpPromptResult() {
+    return { messages: HELP_MESSAGES };
+}
 export function registerAllPrompts(server) {
-    server.registerPrompt(GET_HELP_PROMPT_NAME, GET_HELP_PROMPT_CONFIG, () => ({
-        messages: HELP_MESSAGES,
-    }));
+    server.registerPrompt(GET_HELP_PROMPT.name, {
+        title: GET_HELP_PROMPT.title,
+        description: GET_HELP_PROMPT.description,
+    }, createGetHelpPromptResult);
 }

package/dist/resources/index.d.ts

@@ -1,3 +1,4 @@
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { TypedDb } from '../db/typed.js';
 export declare function registerAllResources(server: McpServer, db: TypedDb): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/resources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAsQ9C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAkEzE"}