@j0hanz/memory-mcp 1.0.0 → 1.1.0

package/dist/instructions.md

@@ -1,123 +0,0 @@
-# MEMORY-MCP INSTRUCTIONS
-
-These instructions are available as a resource `internal://instructions` or prompt `get-help`. Load them when unsure about tool usage.
-
----
-
-## CORE CAPABILITY
-
-- Domain: SQLite-backed memory store with FTS5 search and knowledge graph for AI assistants.
-- Primary Resources: Memories (content+tags+hash), Relationships (directed edges).
-- Tools: `search_memories`, `get_memory`, `recall`, `get_relationships`, `memory_stats`, `retrieve_context` (READ); `store_memory`, `store_memories`, `update_memory`, `delete_memory`, `delete_memories`, `create_relationship`, `delete_relationship` (WRITE).
-
----
-
-## PROMPTS
-
-- `get-help`: Returns these instructions for quick recall.
-
----
-
-## RESOURCES & RESOURCE LINKS
-
-- `internal://instructions`: This document.
-- `memory://memories/{hash}`: Retrieve a single memory by its SHA-256 hash.
-- If a tool response includes a `resourceUri` or `resource_link`, call `resources/read` with the URI to fetch the full payload.
-
----
-
-## THE "GOLDEN PATH" WORKFLOWS (CRITICAL)
-
-### WORKFLOW A: RECALL & EXPLORATION
-
-- Call `search_memories` with `{ query }` to find memories by content/tags.
-- Call `recall` with `{ query, depth }` to traverse graph connections from hits.
-- Call `get_memory` with `{ hash }` for exact retrieval using hash from results.
-  NOTE: Never guess hashes. Always search first.
-
-### WORKFLOW B: KNOWLEDGE MANAGEMENT (STORAGE)
-
-- Call `store_memory` or `store_memories` (batch ≤50) to persist content with tags.
-- Call `create_relationship` to link memories via `{ from_hash, to_hash, relation_type }`.
-- Call `update_memory` with `{ hash, content }` to revise — returns new hash.
-  NOTE: `update_memory` changes the hash because hash depends on content.
-
-### WORKFLOW C: CONTEXT RETRIEVAL (RAG)
-
-- Call `retrieve_context` with `{ query, token_budget }` to get relevant memories fitting a token limit.
-- Use `strategy='importance'` for high-priority items or `strategy='recency'` for latest updates.
-  NOTE: Output is truncated to fit `token_budget`.
-
-### WORKFLOW D: CLEANUP & MAINTENANCE
-
-- Call `delete_memory` or `delete_memories` to remove obsolete items.
-- Call `delete_relationship` to remove specific edges.
-- Call `memory_stats` to monitor database size and health.
-  NOTE: Always confirm destructive actions (delete) with the user first.
-
----
-
-## TOOL NUANCES & GOTCHAS
-
-`store_memory` / `store_memories`
-
-- Purpose: Persist memory content.
-- Input: `tags` (array, no whitespace, max 50 chars each), `importance` (0-10).
-- Output: Returns `hash` and `created` boolean.
-- Gotcha: Idempotent. Storing identical content+tags returns existing hash with `created: false`.
-
-`update_memory`
-
-- Purpose: Modify memory content.
-- Input: Requires `hash` and new `content`. `tags` optional.
-- Output: Returns `old_hash` and `new_hash`.
-- Nuance: Changing content changes the hash. The old memory is effectively replaced.
-
-`search_memories`
-
-- Purpose: FTS5 full-text search over content and tags.
-- Input: `query`, `limit` (default 20), `cursor` for pagination.
-- Limits: Max 100 results per call.
-
-`recall`
-
-- Purpose: Graph traversal starting from search hits.
-- Input: `depth` (0-3, default 1). 0 = search only. Higher depth = more hops.
-- Gotcha: High depth may return large graphs. Use cautiously.
-
-`retrieve_context`
-
-- Purpose: Get memories optimized for LLM context window.
-- Input: `token_budget` (default 4000).
-- Output: `memories` array and `truncated` boolean.
-
-`create_relationship`
-
-- Purpose: Link two memories.
-- Input: `from_hash`, `to_hash`, `relation_type` (e.g., related_to, causes).
-- Gotcha: Both hashes must exist.
-
----
-
-## CROSS-FEATURE RELATIONSHIPS
-
-- Use `store_memory` to get hashes, then `create_relationship` to link them.
-- Use `search_memories` to find entry points for `recall` traversals.
-- `retrieve_context` uses the same ranking as `search_memories` but limits by token count.
-
----
-
-## CONSTRAINTS & LIMITATIONS
-
-- Content size: Max 100,000 characters per memory.
-- Batch size: Max 50 items for `store_memories` and `delete_memories`.
-- Tags: Max 100 tags per memory, no whitespace.
-- Relationships: Directed edges only.
-
----
-
-## ERROR HANDLING STRATEGY
-
-- `E_NOT_FOUND`: Memory hash or relationship not found. → Search/recall to find valid hashes.
-- `E_INVALID_CURSOR`: Pagination cursor invalid or expired. → Restart search without cursor.
-- `E_UNKNOWN`: Unexpected internal error. → Check input format and retry.

package/dist/tools/helpers.d.ts

@@ -1,13 +0,0 @@
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import type { TypedDb } from '../db/typed.js';
-import type { MemoryRow } from '../lib/types.js';
-type LogLevel = 'debug' | 'info' | 'notice' | 'warning' | 'error';
-export declare function logToolEvent(server: McpServer, logger: string, data: unknown, level?: LogLevel): Promise<void>;
-export declare function nowIso(): string;
-export declare function normalizeMemoryType(memoryType?: string): string;
-export declare function getMemoryRow(db: TypedDb, hash: string): MemoryRow | undefined;
-export declare function memoryExists(db: TypedDb, hash: string): boolean;
-export declare function withImmediateTransaction<T>(db: TypedDb, action: () => T): T;
-export declare function notifyMemoryResourceUpdated(server: McpServer, hash: string): Promise<void>;
-export {};
-//# sourceMappingURL=helpers.d.ts.map

package/dist/tools/helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,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,CAMf;AAED,wBAAgB,MAAM,IAAI,MAAM,CAE/B;AAED,wBAAgB,mBAAmB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE7E;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAK/D;AAED,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAU3E;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/tools/helpers.js

@@ -1,49 +0,0 @@
-const DEFAULT_MEMORY_TYPE = 'general';
-const MEMORY_RESOURCE_PREFIX = 'memory://memories/';
-const SELECT_MEMORY_BY_HASH_SQL = 'SELECT * FROM memories WHERE hash = ?';
-const SELECT_MEMORY_HASH_SQL = 'SELECT hash FROM memories WHERE hash = ?';
-export async function logToolEvent(server, logger, data, level = 'info') {
-    if (!server.isConnected()) {
-        return;
-    }
-    await server.sendLoggingMessage({ level, logger, data });
-}
-export function nowIso() {
-    return new Date().toISOString();
-}
-export function normalizeMemoryType(memoryType) {
-    return memoryType ?? DEFAULT_MEMORY_TYPE;
-}
-export function getMemoryRow(db, hash) {
-    return db.prepare(SELECT_MEMORY_BY_HASH_SQL).get(hash);
-}
-export function memoryExists(db, hash) {
-    return (db.prepare(SELECT_MEMORY_HASH_SQL).get(hash) !==
-        undefined);
-}
-export function withImmediateTransaction(db, action) {
-    db.exec('BEGIN IMMEDIATE');
-    try {
-        const result = action();
-        db.exec('COMMIT');
-        return result;
-    }
-    catch (err) {
-        db.exec('ROLLBACK');
-        throw err;
-    }
-}
-export async function notifyMemoryResourceUpdated(server, hash) {
-    if (!server.isConnected()) {
-        return;
-    }
-    try {
-        await server.server.sendResourceUpdated({
-            uri: `${MEMORY_RESOURCE_PREFIX}${hash}`,
-        });
-    }
-    catch {
-        // best-effort notification
-    }
-}
-//# sourceMappingURL=helpers.js.map

package/dist/tools/helpers.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAOA,MAAM,mBAAmB,GAAG,SAAS,CAAC;AACtC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AACpD,MAAM,yBAAyB,GAAG,uCAAuC,CAAC;AAC1E,MAAM,sBAAsB,GAAG,0CAA0C,CAAC;AAE1E,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAiB,EACjB,MAAc,EACd,IAAa,EACb,QAAkB,MAAM;IAExB,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,MAAM,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,UAAmB;IACrD,OAAO,UAAU,IAAI,mBAAmB,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAW,EAAE,IAAY;IACpD,OAAO,EAAE,CAAC,OAAO,CAAY,yBAAyB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAW,EAAE,IAAY;IACpD,OAAO,CACL,EAAE,CAAC,OAAO,CAA0B,sBAAsB,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;QACrE,SAAS,CACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAI,EAAW,EAAE,MAAe;IACtE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;QACxB,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpB,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAiB,EACjB,IAAY;IAEZ,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC;YACtC,GAAG,EAAE,GAAG,sBAAsB,GAAG,IAAI,EAAE;SACxC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;IAC7B,CAAC;AACH,CAAC"}