@j0hanz/memory-mcp 1.3.0 → 1.4.0

package/README.md

@@ -445,18 +445,18 @@ Returns:
 
 ### Environment Variables
 
-| Variable                   | Description                                             | Default     | Required |
-| -------------------------- | ------------------------------------------------------- | ----------- | -------- |
-| `MEMORY_DB_PATH`           | SQLite database file path                               | `memory.db` | No       |
-| `RECALL_MAX_FRONTIER_SIZE` | Max BFS frontier nodes per hop (100–50000)              | `1000`      | No       |
-| `RECALL_MAX_EDGE_ROWS`     | Max relationship rows fetched per traversal (100–50000) | `5000`      | No       |
-| `RECALL_MAX_VISITED_NODES` | Max visited nodes across entire traversal (100–50000)   | `5000`      | No       |
+| Variable                   | Description                                             | Default               | Required |
+| -------------------------- | ------------------------------------------------------- | --------------------- | -------- |
+| `MEMORY_DB_PATH`           | SQLite database file path                               | `memory_db/memory.db` | No       |
+| `RECALL_MAX_FRONTIER_SIZE` | Max BFS frontier nodes per hop (100–50000)              | `1000`                | No       |
+| `RECALL_MAX_EDGE_ROWS`     | Max relationship rows fetched per traversal (100–50000) | `5000`                | No       |
+| `RECALL_MAX_VISITED_NODES` | Max visited nodes across entire traversal (100–50000)   | `5000`                | No       |
 
 > [!IMPORTANT]
-> If `MEMORY_DB_PATH` is relative (including the default `memory.db`), it resolves from the process working directory.
+> If `MEMORY_DB_PATH` is relative (including the default `memory_db/memory.db`), it resolves from the process working directory.
 
 > [!TIP]
-> Add `memory.db` to your `.gitignore` to keep the database out of version control — it contains local session data and should not be shared or committed.
+> Add `memory_db/` to your `.gitignore` to keep the database out of version control — it contains local session data and should not be shared or committed.
 
 ### Limits and Constraints
 

package/dist/completions/index.d.ts

@@ -1,3 +1,2 @@
 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.js

@@ -7,14 +7,15 @@ function escapeLikePattern(value) {
 function normalizeHashPrefix(value) {
     return escapeLikePattern(value.slice(0, HASH_MAX_LENGTH));
 }
+function toHashPrefixLikePattern(value) {
+    return `${normalizeHashPrefix(value)}%`;
+}
 // Returns a completion callback for the `hash` URI variable.
 export function createHashCompletionCallback(db) {
     return (value) => {
-        const escapedPrefix = normalizeHashPrefix(value);
         return db
             .prepareOnce(HASH_COMPLETION_SQL)
-            .all(`${escapedPrefix}%`)
+            .all(toHashPrefixLikePattern(value))
             .map((row) => row.hash);
     };
 }
-//# sourceMappingURL=index.js.map

package/dist/db/index.d.ts

@@ -2,4 +2,3 @@ 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.js

@@ -63,6 +63,18 @@ const SCHEMA_SQL = `
   CREATE INDEX IF NOT EXISTS idx_relationships_to
     ON relationships(to_hash);
 `;
+function runImmediateTransaction(db, action) {
+    db.exec('BEGIN IMMEDIATE');
+    try {
+        const result = action();
+        db.exec('COMMIT');
+        return result;
+    }
+    catch (err) {
+        db.exec('ROLLBACK');
+        throw err;
+    }
+}
 function assertFts5Available(db) {
     try {
         db.exec(FTS5_CHECK_SQL);
@@ -105,8 +117,7 @@ function needsRelationshipsCascadeUpdateMigration(db) {
     return false;
 }
 function migrateRelationshipsCascadeUpdate(db) {
-    db.exec('BEGIN IMMEDIATE');
-    try {
+    runImmediateTransaction(db, () => {
         db.exec('ALTER TABLE relationships RENAME TO relationships_old');
         db.exec(RELATIONSHIPS_TABLE_SQL.replace(' IF NOT EXISTS', ''));
         db.exec(`
@@ -117,12 +128,7 @@ function migrateRelationshipsCascadeUpdate(db) {
         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)');
-        db.exec('COMMIT');
-    }
-    catch (err) {
-        db.exec('ROLLBACK');
-        throw err;
-    }
+    });
 }
 function applyMigrations(db) {
     const currentVersion = readUserVersion(db);
@@ -157,4 +163,3 @@ export function initTypedDatabase(path) {
     const db = initDatabase(path);
     return createTypedDb(db);
 }
-//# sourceMappingURL=index.js.map

package/dist/db/typed.d.ts

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

package/dist/db/typed.js

@@ -6,13 +6,10 @@ export class TypedDb {
     }
     makeStatement(sql) {
         const stmt = this.db.prepare(sql);
-        const materializeParams = (...params) => [
-            ...params,
-        ];
         return {
-            all: (...params) => stmt.all(...materializeParams(...params)),
-            get: (...params) => stmt.get(...materializeParams(...params)),
-            run: (...params) => stmt.run(...materializeParams(...params)),
+            all: (...params) => stmt.all(...params),
+            get: (...params) => stmt.get(...params),
+            run: (...params) => stmt.run(...params),
         };
     }
     prepare(sql) {
@@ -50,4 +47,3 @@ export class TypedDb {
 export function createTypedDb(db) {
     return new TypedDb(db);
 }
-//# sourceMappingURL=typed.js.map

package/dist/index.d.ts

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

package/dist/index.js

@@ -1,14 +1,19 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { existsSync, mkdirSync, renameSync } from 'node:fs';
+import { dirname } from 'node:path';
 import process from 'node:process';
 import { initTypedDatabase } from './db/index.js';
 import { getErrorMessage } from './lib/errors.js';
 import { createServer } from './server.js';
-const MEMORY_DB_PATH = process.env['MEMORY_DB_PATH'] ?? 'memory.db';
+const DEFAULT_DB_PATH = 'memory_db/memory.db';
+const MEMORY_DB_PATH = process.env['MEMORY_DB_PATH'] ?? DEFAULT_DB_PATH;
 const SHUTDOWN_SIGNALS = ['SIGINT', 'SIGTERM'];
 const SHUTDOWN_TIMEOUT_MS = 3000;
 const FORCED_EXIT_CODE = 1;
 const CLEAN_EXIT_CODE = 0;
+const LEGACY_DB_BASENAME = 'memory.db';
+const DEFAULT_DB_DIR = 'memory_db';
 function registerShutdownHandlers(shutdown) {
     for (const signal of SHUTDOWN_SIGNALS) {
         process.on(signal, shutdown);
@@ -50,7 +55,30 @@ function createShutdownHandler(server, db) {
         void runShutdown(server, db);
     };
 }
+function migrateLegacyDatabase() {
+    if (process.env['MEMORY_DB_PATH'])
+        return;
+    if (!existsSync(LEGACY_DB_BASENAME) || existsSync(DEFAULT_DB_PATH))
+        return;
+    try {
+        mkdirSync(dirname(DEFAULT_DB_PATH), { recursive: true });
+        const filesToMove = [
+            LEGACY_DB_BASENAME,
+            `${LEGACY_DB_BASENAME}-shm`,
+            `${LEGACY_DB_BASENAME}-wal`,
+        ];
+        for (const file of filesToMove) {
+            if (existsSync(file)) {
+                renameSync(file, `${DEFAULT_DB_DIR}/${file}`);
+            }
+        }
+    }
+    catch (err) {
+        process.stderr.write(`Warning: Failed to migrate legacy database: ${getErrorMessage(err)}\n`);
+    }
+}
 async function main() {
+    migrateLegacyDatabase();
     const db = initTypedDatabase(MEMORY_DB_PATH);
     const server = createServer(db);
     const transport = new StdioServerTransport();
@@ -62,4 +90,3 @@ main().catch((err) => {
     process.stderr.write(`Fatal error: ${getErrorMessage(err)}\n`);
     process.exit(FORCED_EXIT_CODE);
 });
-//# sourceMappingURL=index.js.map

package/dist/lib/errors.d.ts

@@ -1,3 +1,4 @@
+import { McpError } from '@modelcontextprotocol/sdk/types.js';
 export declare const E_NOT_FOUND = "E_NOT_FOUND";
 export declare const E_INVALID_CURSOR = "E_INVALID_CURSOR";
 export declare const E_DB_ERROR = "E_DB_ERROR";
@@ -5,5 +6,5 @@ export declare const E_CONFLICT = "E_CONFLICT";
 export declare const E_CANCELLED = "E_CANCELLED";
 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.js

@@ -13,8 +13,10 @@ export function getErrorMessage(err) {
         return err;
     return UNKNOWN_ERROR_MESSAGE;
 }
+export function isMcpError(err) {
+    return err instanceof McpError;
+}
 export function rethrowMcpError(err) {
-    if (err instanceof McpError)
+    if (isMcpError(err))
         throw err;
 }
-//# sourceMappingURL=errors.js.map

package/dist/lib/hash.d.ts

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

package/dist/lib/hash.js

@@ -7,7 +7,8 @@ function normalizeTags(tags) {
     return [...tags].sort();
 }
 function stableTagsJson(tags) {
-    return JSON.stringify(normalizeTags(tags));
+    const normalizedTags = normalizeTags(tags);
+    return JSON.stringify(normalizedTags);
 }
 export function computeMemoryHash(content, tags) {
     return createHash(MEMORY_HASH_ALGORITHM)
@@ -15,4 +16,3 @@ export function computeMemoryHash(content, tags) {
         .update(stableTagsJson(tags))
         .digest('hex');
 }
-//# sourceMappingURL=hash.js.map

package/dist/lib/instructions.d.ts

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

package/dist/lib/instructions.js

@@ -1,10 +1,6 @@
 import { buildServerInstructions } from '../resources/instructions.js';
 let cachedInstructions;
 export function loadInstructions() {
-    if (cachedInstructions !== undefined) {
-        return cachedInstructions;
-    }
-    cachedInstructions = buildServerInstructions();
+    cachedInstructions ??= buildServerInstructions();
     return cachedInstructions;
 }
-//# sourceMappingURL=instructions.js.map

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

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

package/dist/lib/json-schema.js

@@ -0,0 +1,9 @@
+import { z } from 'zod/v4';
+export function extractJsonSchema(schema) {
+    try {
+        return z.toJSONSchema(schema);
+    }
+    catch {
+        return {};
+    }
+}

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

@@ -3,4 +3,3 @@ 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.js

@@ -1,5 +1,8 @@
+function isConnected(server) {
+    return server.isConnected();
+}
 export async function logToolEvent(server, logger, data, level = 'info') {
-    if (!server.isConnected()) {
+    if (!isConnected(server)) {
         return;
     }
     try {
@@ -11,7 +14,7 @@ export async function logToolEvent(server, logger, data, level = 'info') {
 }
 const MEMORY_RESOURCE_URI_PREFIX = 'memory://memories/';
 export async function notifyMemoryResourceUpdated(server, hash) {
-    if (!server.isConnected()) {
+    if (!isConnected(server)) {
         return;
     }
     try {
@@ -23,4 +26,3 @@ export async function notifyMemoryResourceUpdated(server, hash) {
         // best-effort notification
     }
 }
-//# sourceMappingURL=mcp-utils.js.map

package/dist/lib/pagination.d.ts

@@ -5,4 +5,3 @@ 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.js

@@ -26,6 +26,9 @@ function parseCursorPayload(cursor) {
     }
     return parsed;
 }
+function invalidCursor() {
+    return new McpError(ErrorCode.InvalidParams, `${E_INVALID_CURSOR}: malformed cursor`);
+}
 export function encodeCursor(offset) {
     const payload = { offset };
     return Buffer.from(JSON.stringify(payload)).toString(CURSOR_ENCODING);
@@ -35,7 +38,7 @@ export function decodeCursor(cursor) {
         return parseCursorPayload(cursor).offset;
     }
     catch {
-        throw new McpError(ErrorCode.InvalidParams, `${E_INVALID_CURSOR}: malformed cursor`);
+        throw invalidCursor();
     }
 }
 export function splitPage(rows, limit) {
@@ -44,4 +47,3 @@ export function splitPage(rows, limit) {
     }
     return { page: rows.slice(), hasMore: false };
 }
-//# sourceMappingURL=pagination.js.map

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

@@ -10,4 +10,3 @@ 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.js

@@ -5,6 +5,7 @@ const CURSOR_ENCODING = 'base64url';
 const CURSOR_VERSION = 2;
 const CURSOR_KIND = 'fts-keyset';
 const CURSOR_SCOPE_HASH_LENGTH = 24;
+const HASH_64_REGEX = /^[a-f0-9]{64}$/;
 function invalidCursor(reason) {
     return new McpError(ErrorCode.InvalidParams, `${E_INVALID_CURSOR}: ${reason}`);
 }
@@ -21,7 +22,7 @@ function isKeysetCursorPayload(value) {
         typeof value['rank'] === 'number' &&
         Number.isFinite(value['rank']) &&
         typeof value['hash'] === 'string' &&
-        /^[a-f0-9]{64}$/.test(value['hash']));
+        HASH_64_REGEX.test(value['hash']));
 }
 function isLegacyOffsetCursorPayload(value) {
     if (!isRecord(value)) {
@@ -86,4 +87,3 @@ export function decodeSearchCursor(cursor, expectedScope) {
     }
     throw invalidCursor('malformed cursor');
 }
-//# sourceMappingURL=search-cursor.js.map

package/dist/lib/search.d.ts

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

package/dist/lib/search.js

@@ -33,7 +33,7 @@ export function buildAndWhereClause(clauses) {
     if (clauses.length === 0) {
         return '';
     }
-    return clauses.map((clause) => ` AND ${clause}`).join('');
+    return ` AND ${clauses.join(' AND ')}`;
 }
 function buildRankedSearchSql(whereExtra, cursor) {
     if (!cursor || cursor.mode === 'offset') {
@@ -64,14 +64,15 @@ export function loadRankedSearchRows(db, query, limit, cursor, filters) {
     return stmt.all(ftsQuery, ...filter.params, cursor.rank, cursor.rank, cursor.hash, limit + 1);
 }
 export function toMemoryFilters(params) {
-    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 } : {}),
-    };
+    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;
 }
-//# sourceMappingURL=search.js.map

package/dist/lib/sql.d.ts

@@ -9,9 +9,8 @@ export declare const SELECT_MEMORY_BY_HASH_SQL = "SELECT * FROM memories WHERE h
 /** Check existence: returns only the hash column to minimise data transfer. */
 export declare const SELECT_MEMORY_HASH_SQL = "SELECT hash FROM memories WHERE hash = ?";
 /** Aggregate memory store stats in a single scan. */
-export declare const MEMORY_AGGREGATE_SQL = "SELECT COUNT(*) AS total, MIN(created_at) AS oldest, MAX(created_at) AS newest, AVG(importance) AS avg_importance FROM memories";
+export declare const MEMORY_AGGREGATE_SQL = "SELECT COUNT(*) AS total,\n          MIN(created_at) AS oldest,\n          MAX(created_at) AS newest,\n          AVG(importance) AS avg_importance\n   FROM memories";
 /** Total relationship count. */
 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.js

@@ -10,9 +10,12 @@ export const SELECT_MEMORY_BY_HASH_SQL = 'SELECT * FROM memories WHERE hash = ?'
 /** Check existence: returns only the hash column to minimise data transfer. */
 export const SELECT_MEMORY_HASH_SQL = 'SELECT hash FROM memories WHERE hash = ?';
 /** Aggregate memory store stats in a single scan. */
-export const MEMORY_AGGREGATE_SQL = 'SELECT COUNT(*) AS total, MIN(created_at) AS oldest, MAX(created_at) AS newest, AVG(importance) AS avg_importance FROM memories';
+export const MEMORY_AGGREGATE_SQL = `SELECT COUNT(*) AS total,
+          MIN(created_at) AS oldest,
+          MAX(created_at) AS newest,
+          AVG(importance) AS avg_importance
+   FROM memories`;
 /** Total relationship count. */
 export const RELATIONSHIP_COUNT_SQL = 'SELECT COUNT(*) AS total FROM relationships';
 /** Per-type memory breakdown. */
 export const TYPE_COUNTS_SQL = 'SELECT memory_type, COUNT(*) AS count FROM memories GROUP BY memory_type ORDER BY count DESC';
-//# sourceMappingURL=sql.js.map

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

@@ -15,4 +15,3 @@ 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.js

@@ -5,7 +5,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'store_memory',
         title: 'Store Memory',
-        description: 'Store a single memory. Returns SHA-256 hash. Idempotent: existing content+tags returns `created: false`. Prefer `store_memories` for batch.',
+        description: 'Store single memory. Returns hash. Idempotent (created: false if exists). Prefer store_memories.',
         inputSchema: StoreMemoryInputSchema,
         outputSchema: StoreResultSchema,
         annotations: {
@@ -18,7 +18,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'store_memories',
         title: 'Store Memories (Batch)',
-        description: 'Store up to 50 memories atomically. Idempotent per item. Returns per-item results. Rolls back entirely on error.',
+        description: 'Store 1-50 memories atomically. Idempotent. Rolls back on error.',
         inputSchema: StoreMemoriesInputSchema,
         outputSchema: BatchResultSchema,
         annotations: {
@@ -31,7 +31,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'get_memory',
         title: 'Get Memory',
-        description: 'Retrieve a single memory by exact SHA-256 hash. Returns memory object or E_NOT_FOUND. Use `search_memories` or `recall` if hash is unknown.',
+        description: 'Retrieve memory by SHA-256 hash. Returns E_NOT_FOUND if missing.',
         inputSchema: GetMemoryInputSchema,
         outputSchema: MemoryResultSchema,
         annotations: {
@@ -43,7 +43,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'search_memories',
         title: 'Search Memories',
-        description: 'FTS5 full-text search over content and tags. Returns ranked results with cursor pagination. Matches alphanumeric/underscore only (all-OR logic). Use `recall` to follow relationships.',
+        description: 'Full-text search (content+tags). Ranked, paginated. Alphanumeric/underscore only. Implicit AND.',
         inputSchema: SearchMemoriesInputSchema,
         outputSchema: SearchResultSchema,
         annotations: {
@@ -55,7 +55,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'retrieve_context',
         title: 'Retrieve Context',
-        description: 'FTS search with token-budget management. Returns memories up to `token_budget`. Sort `strategy`: `relevance` (default), `importance`, or `recency`. Returns `truncated: true` if budget reached. Matches alphanumeric/underscore only.',
+        description: 'FTS search within token budget. Sorts by relevance/importance/recency. Returns truncated: true if limit hit.',
         inputSchema: RetrieveContextInputSchema,
         outputSchema: RetrieveContextResultSchema,
         annotations: {
@@ -67,7 +67,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'recall',
         title: 'Recall (BFS Graph Traversal)',
-        description: 'FTS search then BFS graph traversal up to `depth` hops. Returns discovered memories and edges. Emits progress. Returns `aborted: true` if safety limits hit.',
+        description: 'FTS search + BFS traversal (depth hops). Returns memories+edges. Emits progress. Aborts on limit.',
         inputSchema: RecallInputSchema,
         outputSchema: RecallResultSchema,
         annotations: {
@@ -79,7 +79,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'update_memory',
         title: 'Update Memory',
-        description: 'Replace content/tags of an existing memory. Returns old and new SHA-256 hashes. Returns E_NOT_FOUND if missing, E_CONFLICT if new content+tags already exists.',
+        description: 'Update content/tags. Returns old+new hash. Cascade updates relationships.',
         inputSchema: UpdateMemoryInputSchema,
         outputSchema: UpdateResultSchema,
         annotations: {
@@ -91,7 +91,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'delete_memory',
         title: 'Delete Memory',
-        description: 'Delete a single memory by SHA-256 hash. Cascade-deletes relationships. Returns `{deleted: false}` if not found (idempotent).',
+        description: 'Delete memory by hash. Cascade deletes relationships. Idempotent.',
         inputSchema: DeleteMemoryInputSchema,
         outputSchema: DeleteResultSchema,
         annotations: {
@@ -104,7 +104,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'delete_memories',
         title: 'Delete Memories (Batch)',
-        description: 'Delete up to 50 memories atomically. Cascade-deletes relationships. Per-item `deleted: false` if not found. Rolls back entirely on error.',
+        description: 'Delete 1-50 memories atomically. Cascade deletes. Rolls back on error.',
         inputSchema: DeleteMemoriesInputSchema,
         outputSchema: BatchResultSchema,
         annotations: {
@@ -116,7 +116,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'create_relationship',
         title: 'Create Relationship',
-        description: 'Create directed labeled edge between two memories. Idempotent: existing edge returns `created: false`. Returns E_NOT_FOUND if endpoints missing.',
+        description: 'Create directed edge. Idempotent. Errors if endpoints missing.',
         inputSchema: CreateRelationshipInputSchema,
         outputSchema: CreateRelationshipResultSchema,
         annotations: {
@@ -129,7 +129,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'delete_relationship',
         title: 'Delete Relationship',
-        description: 'Remove a single directed relationship edge. Exact match required (from_hash, to_hash, relation_type). Returns E_NOT_FOUND if missing.',
+        description: 'Delete edge. Exact match required. Errors if missing.',
         inputSchema: DeleteRelationshipInputSchema,
         outputSchema: DeleteRelationshipResultSchema,
         annotations: {
@@ -141,7 +141,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'get_relationships',
         title: 'Get Relationships',
-        description: 'Retrieve all relationships for a memory, with related memory inlined. Filter by direction (outgoing|incoming|both). Returns E_NOT_FOUND if source missing.',
+        description: 'Get relationships for memory. Filter direction. Inlines related memory.',
         inputSchema: GetRelationshipsInputSchema,
         outputSchema: RelationshipResultSchema,
         annotations: {
@@ -153,7 +153,7 @@ export const TOOL_CONTRACTS = [
     {
         name: 'memory_stats',
         title: 'Memory Stats',
-        description: 'Return aggregate statistics: total memories, relationships, oldest/newest timestamps, average importance, and per-type counts.',
+        description: 'Get global stats: counts, timestamps, importance.',
         inputSchema: MemoryStatsInputSchema,
         outputSchema: StatsResultSchema,
         annotations: {
@@ -163,14 +163,14 @@ export const TOOL_CONTRACTS = [
         },
     },
 ];
+const TOOL_CONTRACTS_BY_NAME = new Map(TOOL_CONTRACTS.map((contract) => [contract.name, contract]));
 export function getToolContracts() {
     return TOOL_CONTRACTS;
 }
 export function getToolContract(name) {
-    const contract = TOOL_CONTRACTS.find((c) => c.name === name);
+    const contract = TOOL_CONTRACTS_BY_NAME.get(name);
     if (!contract) {
         throw new Error(`Tool contract not found: ${name}`);
     }
     return contract;
 }
-//# sourceMappingURL=tool-contracts.js.map

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

@@ -1,4 +1,3 @@
 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.js

@@ -8,15 +8,16 @@ function createStructuredError(code, message) {
     };
 }
 export function createToolResponse(payload) {
+    const textContent = toTextContent(payload);
     return {
-        content: [toTextContent(payload)],
+        content: [textContent],
         structuredContent: payload,
     };
 }
 export function createErrorResponse(code, message) {
+    const errorPayload = createStructuredError(code, message);
     return {
-        content: [toTextContent(createStructuredError(code, message))],
+        content: [toTextContent(errorPayload)],
         isError: true,
     };
 }
-//# sourceMappingURL=tool-response.js.map

package/dist/lib/types.d.ts

@@ -72,4 +72,3 @@ 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.js

@@ -12,10 +12,11 @@ export function parseTags(tagsJson) {
 }
 export function parseMemoryRow(row) {
     const relevance = row.rank != null ? -row.rank : undefined;
+    const tags = parseTags(row.tags);
     return {
         hash: row.hash,
         content: row.content,
-        tags: parseTags(row.tags),
+        tags,
         memory_type: row.memory_type,
         importance: row.importance,
         created_at: row.created_at,
@@ -23,4 +24,3 @@ export function parseMemoryRow(row) {
         ...(relevance != null ? { relevance } : {}),
     };
 }
-//# sourceMappingURL=types.js.map

package/dist/prompts/index.d.ts

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