@j0hanz/memory-mcp 1.0.0 → 1.1.0

package/README.md

@@ -22,7 +22,7 @@ Memory MCP provides a local, persistent memory layer for MCP-enabled assistants.
 - **Token-budget retrieval** (`retrieve_context`) selects memories that fit a caller-specified token budget — no manual pagination needed.
 - **Strict Zod input validation** with typed output envelopes and SHA-256 hash addressing.
 - **Resource support** with `internal://instructions` (Markdown guide) and `memory://memories/{hash}` URI template with hash auto-completion.
-- **stdio transport** with clean shutdown handling (`SIGINT`, `SIGTERM`) and no HTTP endpoints.
+- **stdio transport** with clean shutdown handling (`SIGINT`, `SIGTERM`) and no HTTP endpoints. |
 
 ## Requirements
 
@@ -192,6 +192,16 @@ MCP client config:
 
 </details>
 
+## Documentation Maintenance
+
+- **Owner**: maintainers updating MCP behavior in `src/` must update `README.md` and affected `mcp/` mirror pages in the same PR.
+- **Link/version policy**: use pinned `https://modelcontextprotocol.io/specification/2025-11-25/...` links for protocol references; avoid `latest` and mixed legacy targets.
+- **Drift-check checklist**:
+  - Re-verify capability declarations in `src/server.ts`.
+  - Reconcile tool/resource/prompt docs with `src/tools/index.ts`, `src/resources/index.ts`, and `src/prompts/index.ts`.
+  - Confirm limitations/gotchas in `src/instructions.md` match runtime behavior.
+- **Validation commands**: `npm run type-check`, `npm run test:fast`, `npm run build`.
+
 ## MCP Surface
 
 ### Tools Summary
@@ -225,7 +235,7 @@ Store a new memory with content, tags, and optional type/importance. Idempotent
 | `memory_type` | enum       | No       | `general` | `general`, `fact`, `plan`, `decision`, `reflection`, `lesson`, `error`, `gradient` |
 | `importance`  | `integer`  | No       | `0`       | Priority 0–10                                                                      |
 
-Returns: `{ ok, result: { hash, created } }`
+Returns: `{ hash, created }`
 
 ---
 
@@ -237,7 +247,7 @@ Store multiple memories in one transaction (max 50 items).
 | ------- | ------------------------ | -------- | -------------------------------------------------------------------------------------- |
 | `items` | `Array<StoreMemoryItem>` | Yes      | 1–50 items, each with `content`, `tags`, optional `memory_type`, optional `importance` |
 
-Returns: `{ ok, result: { items, succeeded, failed } }`
+Returns: `{ items, succeeded, failed }`
 
 ---
 
@@ -249,7 +259,7 @@ Retrieve one memory by its SHA-256 hash.
 | ------ | -------- | -------- | ----------------------------- |
 | `hash` | `string` | Yes      | 64-char lowercase SHA-256 hex |
 
-Returns: `{ ok, result: Memory }` or `{ ok: false, error }` on `E_NOT_FOUND`.
+Returns: `Memory` or `{ ok: false, error }` on `E_NOT_FOUND`.
 
 ---
 
@@ -263,7 +273,7 @@ Update content and optionally tags for an existing memory. Returns both hashes.
 | `content` | `string`   | Yes      | —             | Replacement content  |
 | `tags`    | `string[]` | No       | Existing tags | Replacement tags     |
 
-Returns: `{ ok, result: { old_hash, new_hash } }`
+Returns: `{ old_hash, new_hash }`
 
 ---
 
@@ -275,7 +285,7 @@ Delete one memory by hash. Cascades to related relationship rows.
 | ------ | -------- | -------- | ----------- |
 | `hash` | `string` | Yes      | Memory hash |
 
-Returns: `{ ok, result: { hash, deleted } }`
+Returns: `{ hash, deleted }`
 
 ---
 
@@ -287,7 +297,7 @@ Delete multiple memories by hash in one transaction.
 | -------- | ---------- | -------- | ------------------ |
 | `hashes` | `string[]` | Yes      | 1–50 memory hashes |
 
-Returns: `{ ok, result: { items, succeeded, failed } }`
+Returns: `{ items, succeeded, failed }`
 
 ---
 
@@ -304,7 +314,7 @@ Full-text search over memory content and tags using FTS5. Supports importance an
 | `max_importance` | `integer` | No       | —       | Only return memories with importance <= this value (0–10) |
 | `memory_type`    | enum      | No       | —       | Filter by memory type                                     |
 
-Returns: `{ ok, result: { memories, total_returned, nextCursor? } }`
+Returns: `{ memories, total_returned, nextCursor? }`
 
 ---
 
@@ -320,7 +330,7 @@ Suggested `relation_type` values: `related_to`, `causes`, `depends_on`, `parent_
 | `to_hash`       | `string` | Yes      | Target memory hash                                |
 | `relation_type` | `string` | Yes      | Edge label (1–50 chars, no whitespace, free-form) |
 
-Returns: `{ ok, result: { created } }`
+Returns: `{ created }`
 
 ---
 
@@ -334,7 +344,7 @@ Delete one directed relationship edge.
 | `to_hash`       | `string` | Yes      | Target hash       |
 | `relation_type` | `string` | Yes      | Relationship type |
 
-Returns: `{ ok, result: { deleted } }` or `{ ok: false, error }` on `E_NOT_FOUND`.
+Returns: `{ deleted }` or `{ ok: false, error }` on `E_NOT_FOUND`.
 
 ---
 
@@ -347,7 +357,7 @@ Retrieve relationships for a memory, with optional direction filter.
 | `hash`      | `string` | Yes      | —       | Memory hash                       |
 | `direction` | enum     | No       | `both`  | `outgoing`, `incoming`, or `both` |
 
-Returns: `{ ok, result: { relationships, count } }`
+Returns: `{ relationships, count }`
 
 Each relationship includes `from_hash`, `to_hash`, `relation_type`, `created_at`, `linked_hash`, `linked_content`, and `linked_tags`.
 
@@ -367,7 +377,7 @@ Search memories by full-text query, then traverse the relationship graph up to `
 | `max_importance` | `integer` | No       | —       | Seed filter: only memories with importance <= value (0–10) |
 | `memory_type`    | enum      | No       | —       | Seed filter: only memories of this type                    |
 
-Returns: `{ ok, result: { memories, graph, depth_reached, aborted?, nextCursor? } }`
+Returns: `{ memories, graph, depth_reached, aborted?, nextCursor? }`
 
 Each item in `graph` uses the shape:
 
@@ -390,7 +400,7 @@ Search memories and return relevance-ranked results that fit within a caller-spe
 | `token_budget` | `integer` | No       | `4000`      | Maximum estimated tokens to return (100–200000)                                            |
 | `strategy`     | enum      | No       | `relevance` | Sort order: `relevance` (FTS rank), `importance` (highest first), `recency` (newest first) |
 
-Returns: `{ ok, result: { memories, estimated_tokens, truncated } }`
+Returns: `{ memories, estimated_tokens, truncated }`
 
 > [!TIP]
 > Token estimation is approximate (content length ÷ 4). `truncated: true` means the budget was reached before all candidates were included.
@@ -405,17 +415,14 @@ Returns:
 
 ```json
 {
-  "ok": true,
-  "result": {
-    "memories": {
-      "total": 0,
-      "oldest": null,
-      "newest": null,
-      "avg_importance": null
-    },
-    "relationships": { "total": 0 },
-    "by_type": {}
-  }
+  "memories": {
+    "total": 0,
+    "oldest": null,
+    "newest": null,
+    "avg_importance": null
+  },
+  "relationships": { "total": 0 },
+  "by_type": {}
 }
 ```
 
@@ -469,7 +476,7 @@ Returns:
 | SQLite busy timeout             | 5000 ms                                           |
 
 > [!NOTE]
-> Cursor values are base64url-encoded offsets. Treat them as opaque tokens.
+> Cursor values are opaque base64url-encoded tokens. Treat them as opaque and do not parse them.
 
 ## Security
 

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

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

package/dist/completions/index.js

@@ -1,17 +1,20 @@
 const HASH_MAX_LENGTH = 64;
 const HASH_COMPLETION_LIMIT = 101;
 const HASH_COMPLETION_SQL = `SELECT hash FROM memories WHERE hash LIKE ? ESCAPE '\\' ORDER BY hash LIMIT ${HASH_COMPLETION_LIMIT}`;
+function escapeLikePattern(value) {
+    return value.replace(/[%_\\]/g, '\\$&');
+}
+function normalizeHashPrefix(value) {
+    return escapeLikePattern(value.slice(0, HASH_MAX_LENGTH));
+}
 // Returns a completion callback for the `hash` URI variable.
 export function createHashCompletionCallback(db) {
     return (value) => {
-        const escapedPrefix = escapeLikePattern(value.slice(0, HASH_MAX_LENGTH));
-        const rows = db
-            .prepare(HASH_COMPLETION_SQL)
-            .all(`${escapedPrefix}%`);
-        return rows.map((r) => r.hash);
+        const escapedPrefix = normalizeHashPrefix(value);
+        return db
+            .prepareOnce(HASH_COMPLETION_SQL)
+            .all(`${escapedPrefix}%`)
+            .map((row) => row.hash);
     };
 }
-function escapeLikePattern(value) {
-    return value.replace(/[%_\\]/g, '\\$&');
-}
 //# sourceMappingURL=index.js.map

package/dist/completions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/completions/index.ts"],"names":[],"mappings":"AAGA,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,mBAAmB,GAAG,+EAA+E,qBAAqB,EAAE,CAAC;AAEnI,6DAA6D;AAC7D,MAAM,UAAU,4BAA4B,CAC1C,EAAW;IAEX,OAAO,CAAC,KAAa,EAAY,EAAE;QACjC,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;QACzE,MAAM,IAAI,GAAG,EAAE;aACZ,OAAO,CAAU,mBAAmB,CAAC;aACrC,GAAG,CAAC,GAAG,aAAa,GAAG,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/completions/index.ts"],"names":[],"mappings":"AAGA,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,mBAAmB,GAAG,+EAA+E,qBAAqB,EAAE,CAAC;AAEnI,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,OAAO,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,6DAA6D;AAC7D,MAAM,UAAU,4BAA4B,CAC1C,EAAW;IAEX,OAAO,CAAC,KAAa,EAAY,EAAE;QACjC,MAAM,aAAa,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACjD,OAAO,EAAE;aACN,WAAW,CAAU,mBAAmB,CAAC;aACzC,GAAG,CAAC,GAAG,aAAa,GAAG,CAAC;aACxB,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC"}

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

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

package/dist/db/index.js

@@ -4,8 +4,17 @@ import { DatabaseSync } from 'node:sqlite';
 import { createTypedDb } from './typed.js';
 const SQLITE_TIMEOUT_MS = 5000;
 const STATEMENT_CACHE_SIZE = 1000;
+const TARGET_SCHEMA_VERSION = 2;
 const FTS5_CHECK_SQL = 'CREATE VIRTUAL TABLE IF NOT EXISTS __fts5_check USING fts5(x); DROP TABLE __fts5_check;';
 const FTS5_REQUIRED_MESSAGE = 'SQLite FTS5 extension is not available. memory-mcp requires a SQLite build with FTS5 support.';
+const DEFENSIVE_PRAGMA_SQL = 'PRAGMA defensive = ON';
+const RELATIONSHIPS_TABLE_SQL = `CREATE TABLE IF NOT EXISTS relationships (
+    from_hash TEXT NOT NULL REFERENCES memories(hash) ON DELETE CASCADE ON UPDATE CASCADE,
+    to_hash TEXT NOT NULL REFERENCES memories(hash) ON DELETE CASCADE ON UPDATE CASCADE,
+    relation_type TEXT NOT NULL,
+    created_at TEXT NOT NULL,
+    PRIMARY KEY (from_hash, to_hash, relation_type)
+  ) STRICT;`;
 const SCHEMA_SQL = `
   CREATE TABLE IF NOT EXISTS memories (
     hash TEXT PRIMARY KEY NOT NULL,
@@ -41,13 +50,7 @@ const SCHEMA_SQL = `
       VALUES ('delete', old.rowid, old.content, old.tags);
   END;
 
-  CREATE TABLE IF NOT EXISTS relationships (
-    from_hash TEXT NOT NULL REFERENCES memories(hash) ON DELETE CASCADE,
-    to_hash TEXT NOT NULL REFERENCES memories(hash) ON DELETE CASCADE,
-    relation_type TEXT NOT NULL,
-    created_at TEXT NOT NULL,
-    PRIMARY KEY (from_hash, to_hash, relation_type)
-  ) STRICT;
+  ${RELATIONSHIPS_TABLE_SQL}
 
   CREATE INDEX IF NOT EXISTS idx_memories_importance
     ON memories(importance DESC);
@@ -76,12 +79,69 @@ function ensureParentDir(path) {
     }
     mkdirSync(dirname(path), { recursive: true });
 }
+function readUserVersion(db) {
+    const row = db.prepare('PRAGMA user_version').get();
+    return row?.user_version ?? 0;
+}
+function writeUserVersion(db, version) {
+    db.exec(`PRAGMA user_version = ${version}`);
+}
+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) {
+            continue;
+        }
+        if (row.on_update.toUpperCase() !== 'CASCADE') {
+            return true;
+        }
+    }
+    return false;
+}
+function migrateRelationshipsCascadeUpdate(db) {
+    db.exec('BEGIN IMMEDIATE');
+    try {
+        db.exec('ALTER TABLE relationships RENAME TO relationships_old');
+        db.exec(RELATIONSHIPS_TABLE_SQL.replace(' IF NOT EXISTS', ''));
+        db.exec(`
+      INSERT INTO relationships (from_hash, to_hash, relation_type, created_at)
+      SELECT from_hash, to_hash, relation_type, created_at
+      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)');
+        db.exec('COMMIT');
+    }
+    catch (err) {
+        db.exec('ROLLBACK');
+        throw err;
+    }
+}
+function applyMigrations(db) {
+    const currentVersion = readUserVersion(db);
+    const needsCascadeMigration = needsRelationshipsCascadeUpdateMigration(db);
+    if (needsCascadeMigration) {
+        migrateRelationshipsCascadeUpdate(db);
+    }
+    if (currentVersion < TARGET_SCHEMA_VERSION || needsCascadeMigration) {
+        writeUserVersion(db, TARGET_SCHEMA_VERSION);
+    }
+}
 function configureDatabase(db) {
     // Enable defensive mode (SQLite v3.39+ / Node 24.12+: prevents deliberate DB corruption)
-    db.exec('PRAGMA defensive = ON');
+    db.exec(DEFENSIVE_PRAGMA_SQL);
     // Verify FTS5 support
     assertFts5Available(db);
     db.exec(SCHEMA_SQL);
+    applyMigrations(db);
 }
 export function initDatabase(path) {
     ensureParentDir(path);

package/dist/db/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAoB,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAEzD,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAC/B,MAAM,oBAAoB,GAAG,IAAI,CAAC;AAClC,MAAM,cAAc,GAClB,yFAAyF,CAAC;AAC5F,MAAM,qBAAqB,GACzB,+FAA+F,CAAC;AAElG,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDlB,CAAC;AAEF,SAAS,mBAAmB,CAAC,EAAgB;IAC3C,IAAI,CAAC;QACH,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACzC,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,cAAc,GAAG,IAAI,KAAK,UAAU,CAAC;IAC3C,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IACD,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,iBAAiB,CAAC,EAAgB;IACzC,yFAAyF;IACzF,EAAE,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAEjC,sBAAsB;IACtB,mBAAmB,CAAC,EAAE,CAAC,CAAC;IAExB,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,eAAe,CAAC,IAAI,CAAC,CAAC;IAEtB,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,IAAI,EAAE;QAChC,2BAA2B,EAAE,IAAI;QACjC,OAAO,EAAE,iBAAiB;KAC3B,CAAC,CAAC;IAEH,iBAAiB,CAAC,EAAE,CAAC,CAAC;IAEtB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,aAAa,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAgB;IACnD,OAAO,EAAE,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC;AACjD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"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"}

package/dist/db/typed.d.ts

@@ -1,15 +1,21 @@
 import type { DatabaseSync, SQLInputValue, StatementResultingChanges } from 'node:sqlite';
+type SqlParams = readonly SQLInputValue[];
 export interface TypedStatement<T> {
-    all(...params: SQLInputValue[]): T[];
-    get(...params: SQLInputValue[]): T | undefined;
-    run(...params: SQLInputValue[]): StatementResultingChanges;
+    all(...params: SqlParams): T[];
+    get(...params: SqlParams): T | undefined;
+    run(...params: SqlParams): StatementResultingChanges;
 }
 export declare class TypedDb {
     private readonly db;
+    private readonly cache;
     constructor(db: DatabaseSync);
+    private makeStatement;
     prepare<T>(sql: string): TypedStatement<T>;
+    prepareOnce<T>(sql: string): TypedStatement<T>;
+    transaction<T>(action: () => T): T;
     exec(sql: string): void;
     close(): void;
 }
 export declare function createTypedDb(db: DatabaseSync): TypedDb;
+export {};
 //# sourceMappingURL=typed.d.ts.map

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

@@ -1 +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,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,GAAG,CAAC,GAAG,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,CAAC;IACrC,GAAG,CAAC,GAAG,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC;IAC/C,GAAG,CAAC,GAAG,MAAM,EAAE,aAAa,EAAE,GAAG,yBAAyB,CAAC;CAC5D;AAED,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,YAAY;IAE7C,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC;IAS1C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvB,KAAK,IAAI,IAAI;CAGd;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,YAAY,GAAG,OAAO,CAEvD"}
+{"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;IAcrB,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/db/typed.js

@@ -1,20 +1,49 @@
 export class TypedDb {
     db;
+    cache = new Map();
     constructor(db) {
         this.db = db;
     }
-    prepare(sql) {
+    makeStatement(sql) {
         const stmt = this.db.prepare(sql);
+        const materializeParams = (...params) => [
+            ...params,
+        ];
         return {
-            all: (...params) => stmt.all(...params),
-            get: (...params) => stmt.get(...params),
-            run: (...params) => stmt.run(...params),
+            all: (...params) => stmt.all(...materializeParams(...params)),
+            get: (...params) => stmt.get(...materializeParams(...params)),
+            run: (...params) => stmt.run(...materializeParams(...params)),
         };
     }
+    prepare(sql) {
+        return this.makeStatement(sql);
+    }
+    prepareOnce(sql) {
+        const cached = this.cache.get(sql);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const stmt = this.makeStatement(sql);
+        this.cache.set(sql, stmt);
+        return stmt;
+    }
+    transaction(action) {
+        this.db.exec('BEGIN IMMEDIATE');
+        try {
+            const result = action();
+            this.db.exec('COMMIT');
+            return result;
+        }
+        catch (err) {
+            this.db.exec('ROLLBACK');
+            throw err;
+        }
+    }
     exec(sql) {
         this.db.exec(sql);
     }
     close() {
+        this.cache.clear();
         this.db.close();
     }
 }

package/dist/db/typed.js.map

@@ -1 +1 @@
-{"version":3,"file":"typed.js","sourceRoot":"","sources":["../../src/db/typed.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,OAAO;IACW;IAA7B,YAA6B,EAAgB;QAAhB,OAAE,GAAF,EAAE,CAAc;IAAG,CAAC;IAEjD,OAAO,CAAI,GAAW;QACpB,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO;YACL,GAAG,EAAE,CAAC,GAAG,MAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAQ;YAC/D,GAAG,EAAE,CAAC,GAAG,MAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAkB;YACzE,GAAG,EAAE,CAAC,GAAG,MAAuB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;SACzD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,EAAgB;IAC5C,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"typed.js","sourceRoot":"","sources":["../../src/db/typed.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,OAAO;IAGW;IAFZ,KAAK,GAAG,IAAI,GAAG,EAAmC,CAAC;IAEpE,YAA6B,EAAgB;QAAhB,OAAE,GAAF,EAAE,CAAc;IAAG,CAAC;IAEzC,aAAa,CAAI,GAAW;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,iBAAiB,GAAG,CAAC,GAAG,MAAiB,EAAmB,EAAE,CAAC;YACnE,GAAG,MAAM;SACV,CAAC;QACF,OAAO;YACL,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAE,EAAE,CAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,GAAG,MAAM,CAAC,CAAQ;YAClD,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAE,EAAE,CAC5B,IAAI,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,GAAG,MAAM,CAAC,CAAkB;YAC5D,GAAG,EAAE,CAAC,GAAG,MAAiB,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,GAAG,MAAM,CAAC,CAAC;SACzE,CAAC;IACJ,CAAC;IAED,OAAO,CAAI,GAAW;QACpB,OAAO,IAAI,CAAC,aAAa,CAAI,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,WAAW,CAAI,GAAW;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAA2B,CAAC;QACrC,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAI,GAAG,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,WAAW,CAAI,MAAe;QAC5B,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;YACxB,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAW;QACd,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,EAAgB;IAC5C,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC"}

package/dist/index.js

@@ -2,15 +2,13 @@
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 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 SHUTDOWN_SIGNALS = ['SIGINT', 'SIGTERM'];
 const SHUTDOWN_TIMEOUT_MS = 3000;
 const FORCED_EXIT_CODE = 1;
 const CLEAN_EXIT_CODE = 0;
-function formatFatalError(err) {
-    return err instanceof Error ? err.message : String(err);
-}
 function registerShutdownHandlers(shutdown) {
     for (const signal of SHUTDOWN_SIGNALS) {
         process.on(signal, shutdown);
@@ -24,16 +22,23 @@ function scheduleForcedShutdown() {
     timer.unref();
     return timer;
 }
-async function runShutdown(server, db) {
-    const timer = scheduleForcedShutdown();
+async function closeServer(server) {
     try {
         await server.close();
     }
     catch {
         // ignore close errors
     }
-    db.close();
-    clearTimeout(timer);
+}
+async function runShutdown(server, db) {
+    const timer = scheduleForcedShutdown();
+    try {
+        await closeServer(server);
+        db.close();
+    }
+    finally {
+        clearTimeout(timer);
+    }
     process.exit(CLEAN_EXIT_CODE);
 }
 function createShutdownHandler(server, db) {
@@ -54,7 +59,7 @@ async function main() {
     await server.connect(transport);
 }
 main().catch((err) => {
-    process.stderr.write(`Fatal error: ${formatFatalError(err)}\n`);
+    process.stderr.write(`Fatal error: ${getErrorMessage(err)}\n`);
     process.exit(FORCED_EXIT_CODE);
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,WAAW,CAAC;AACpE,MAAM,gBAAgB,GAAqB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACjE,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,SAAS,gBAAgB,CAAC,GAAY;IACpC,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,wBAAwB,CAAC,QAAoB;IACpD,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB;IAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACjC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,MAAuC,EACvC,EAAwC;IAExC,MAAM,KAAK,GAAG,sBAAsB,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;IACD,EAAE,CAAC,KAAK,EAAE,CAAC;IACX,YAAY,CAAC,KAAK,CAAC,CAAC;IACpB,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAAuC,EACvC,EAAwC;IAExC,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,OAAO,GAAG,EAAE;QACV,IAAI,cAAc;YAAE,OAAO;QAC3B,cAAc,GAAG,IAAI,CAAC;QACtB,KAAK,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnD,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAEnC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,WAAW,CAAC;AACpE,MAAM,gBAAgB,GAAqB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;AACjE,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B,SAAS,wBAAwB,CAAC,QAAoB;IACpD,KAAK,MAAM,MAAM,IAAI,gBAAgB,EAAE,CAAC;QACtC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB;IAC7B,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC5D,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACjC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IACxB,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,MAAuC;IAEvC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAAC,MAAM,CAAC;QACP,sBAAsB;IACxB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,MAAuC,EACvC,EAAwC;IAExC,MAAM,KAAK,GAAG,sBAAsB,EAAE,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;QAC1B,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAAuC,EACvC,EAAwC;IAExC,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,OAAO,GAAG,EAAE;QACV,IAAI,cAAc;YAAE,OAAO;QAC3B,cAAc,GAAG,IAAI,CAAC;QACtB,KAAK,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC/B,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnD,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAEnC,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/D,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC"}

package/dist/lib/errors.d.ts

@@ -1,5 +1,9 @@
 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";
+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 rethrowMcpError(err: unknown): void;
 //# sourceMappingURL=errors.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AACnD,eAAO,MAAM,SAAS,cAAc,CAAC;AAErC,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKpD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAEA,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,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAElD"}

package/dist/lib/errors.js

@@ -1,12 +1,20 @@
+import { McpError } from '@modelcontextprotocol/sdk/types.js';
 export const E_NOT_FOUND = 'E_NOT_FOUND';
 export const E_INVALID_CURSOR = 'E_INVALID_CURSOR';
+export const E_DB_ERROR = 'E_DB_ERROR';
+export const E_CONFLICT = 'E_CONFLICT';
+export const E_CANCELLED = 'E_CANCELLED';
 export const E_UNKNOWN = 'E_UNKNOWN';
+const UNKNOWN_ERROR_MESSAGE = 'Unknown error occurred';
 export function getErrorMessage(err) {
     if (err instanceof Error)
         return err.message;
-    const errorAsString = typeof err === 'string' ? err : undefined;
-    if (errorAsString != null)
-        return errorAsString;
-    return 'Unknown error occurred';
+    if (typeof err === 'string')
+        return err;
+    return UNKNOWN_ERROR_MESSAGE;
+}
+export function rethrowMcpError(err) {
+    if (err instanceof McpError)
+        throw err;
 }
 //# sourceMappingURL=errors.js.map

package/dist/lib/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AACnD,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AAErC,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,MAAM,aAAa,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,IAAI,aAAa,IAAI,IAAI;QAAE,OAAO,aAAa,CAAC;IAChD,OAAO,wBAAwB,CAAC;AAClC,CAAC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AAE9D,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AACnD,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;AACrC,MAAM,qBAAqB,GAAG,wBAAwB,CAAC;AAEvD,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,GAAG,YAAY,KAAK;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC7C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC;IACxC,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAY;IAC1C,IAAI,GAAG,YAAY,QAAQ;QAAE,MAAM,GAAG,CAAC;AACzC,CAAC"}

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

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

package/dist/lib/hash.js

@@ -1,11 +1,18 @@
 import { createHash } from 'node:crypto';
+const MEMORY_HASH_ALGORITHM = 'sha256';
 function normalizeTags(tags) {
+    if (tags.length < 2) {
+        return tags;
+    }
     return [...tags].sort();
 }
+function stableTagsJson(tags) {
+    return JSON.stringify(normalizeTags(tags));
+}
 export function computeMemoryHash(content, tags) {
-    return createHash('sha256')
+    return createHash(MEMORY_HASH_ALGORITHM)
         .update(content)
-        .update(JSON.stringify(normalizeTags(tags)))
+        .update(stableTagsJson(tags))
         .digest('hex');
 }
 //# sourceMappingURL=hash.js.map

package/dist/lib/hash.js.map

@@ -1 +1 @@
-{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/lib/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,SAAS,aAAa,CAAC,IAAuB;IAC5C,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,IAAuB;IAEvB,OAAO,UAAU,CAAC,QAAQ,CAAC;SACxB,MAAM,CAAC,OAAO,CAAC;SACf,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;SAC3C,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/lib/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,qBAAqB,GAAG,QAAQ,CAAC;AAEvC,SAAS,aAAa,CAAC,IAAuB;IAC5C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,cAAc,CAAC,IAAuB;IAC7C,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,IAAuB;IAEvB,OAAO,UAAU,CAAC,qBAAqB,CAAC;SACrC,MAAM,CAAC,OAAO,CAAC;SACf,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;SAC5B,MAAM,CAAC,KAAK,CAAC,CAAC;AACnB,CAAC"}

package/dist/lib/instructions.d.ts

@@ -0,0 +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":"AAwEA,wBAAgB,gBAAgB,IAAI,MAAM,CA+BzC"}