@j0hanz/memory-mcp 0.1.0

package/dist/server.js

@@ -0,0 +1,73 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { readFileSync } from 'node:fs';
+import { findPackageJSON } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { registerAllPrompts } from './prompts/index.js';
+import { registerAllResources } from './resources/index.js';
+import { TOOL_REGISTRARS } from './tools/index.js';
+const ICON_ASSET = 'logo.svg';
+const ICON_MIME = 'image/svg+xml';
+const ICON_SIZES = ['any'];
+const MAX_ICON_BYTES = 2 * 1024 * 1024;
+const SERVER_NAME = 'memory-mcp';
+function loadPackageJson() {
+    const pkgPath = findPackageJSON('.', import.meta.url);
+    if (!pkgPath) {
+        throw new Error('Could not find package.json');
+    }
+    return JSON.parse(readFileSync(pkgPath, 'utf-8'));
+}
+function loadPackageVersion() {
+    const { version } = loadPackageJson();
+    return version;
+}
+function getLocalIconData() {
+    const candidates = [
+        new URL(`../assets/${ICON_ASSET}`, import.meta.url),
+        new URL(`./assets/${ICON_ASSET}`, import.meta.url),
+    ];
+    for (const candidate of candidates) {
+        try {
+            const filePath = fileURLToPath(candidate);
+            const buf = readFileSync(filePath);
+            if (buf.byteLength >= MAX_ICON_BYTES) {
+                console.warn(`Icon asset exceeds 2 MB (${buf.byteLength} bytes), skipping.`);
+                return undefined;
+            }
+            return `data:${ICON_MIME};base64,${buf.toString('base64')}`;
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return undefined;
+}
+function createIconDescriptors() {
+    const src = getLocalIconData();
+    if (!src)
+        return undefined;
+    return [{ src, mimeType: ICON_MIME, sizes: ICON_SIZES }];
+}
+export function createServer(db) {
+    const icons = createIconDescriptors();
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: loadPackageVersion(),
+        ...(icons ? { icons } : {}),
+    }, {
+        capabilities: {
+            logging: {},
+            completions: {},
+            resources: { subscribe: true },
+            prompts: {},
+            tools: {},
+        },
+    });
+    for (const registerTool of TOOL_REGISTRARS) {
+        registerTool(server, db);
+    }
+    registerAllResources(server, db);
+    registerAllPrompts(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/create-relationship.d.ts

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

package/dist/tools/create-relationship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-relationship.d.ts","sourceRoot":"","sources":["../../src/tools/create-relationship.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAkB9C,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,EAAE,EAAE,OAAO,GACV,IAAI,CAoDN"}

package/dist/tools/create-relationship.js

@@ -0,0 +1,49 @@
+import { E_NOT_FOUND, E_UNKNOWN, getErrorMessage } from '../lib/errors.js';
+import { createErrorResponse, createToolResponse, } from '../lib/tool-response.js';
+import { CreateRelationshipInputSchema } from '../schemas/inputs.js';
+import { CreateRelationshipResultSchema } from '../schemas/outputs.js';
+import { logToolEvent, memoryExists, nowIso } from './helpers.js';
+const INSERT_RELATIONSHIP_SQL = `INSERT OR IGNORE INTO relationships (from_hash, to_hash, relation_type, created_at)
+  VALUES (?, ?, ?, ?)`;
+function formatMemoryNotFound(kind, hash) {
+    return `${kind} memory not found: ${hash}`;
+}
+export function registerCreateRelationship(server, db) {
+    server.registerTool('create_relationship', {
+        title: 'Create Relationship',
+        description: 'Create a directed labeled edge between two memories. Idempotent — re-creating an existing relationship is a no-op.',
+        inputSchema: CreateRelationshipInputSchema,
+        outputSchema: CreateRelationshipResultSchema,
+        annotations: { idempotentHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            if (!memoryExists(db, params.from_hash)) {
+                return createErrorResponse(E_NOT_FOUND, formatMemoryNotFound('Source', params.from_hash));
+            }
+            if (!memoryExists(db, params.to_hash)) {
+                return createErrorResponse(E_NOT_FOUND, formatMemoryNotFound('Target', params.to_hash));
+            }
+            const now = nowIso();
+            const result = db
+                .prepare(INSERT_RELATIONSHIP_SQL)
+                .run(params.from_hash, params.to_hash, params.relation_type, now);
+            const created = result.changes > 0;
+            await logToolEvent(server, 'create_relationship', {
+                fromHash: params.from_hash,
+                toHash: params.to_hash,
+                relationType: params.relation_type,
+                created,
+            });
+            return createToolResponse({
+                ok: true,
+                result: {
+                    created,
+                },
+            });
+        }
+        catch (err) {
+            return createErrorResponse(E_UNKNOWN, getErrorMessage(err));
+        }
+    });
+}
+//# sourceMappingURL=create-relationship.js.map

package/dist/tools/create-relationship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-relationship.js","sourceRoot":"","sources":["../../src/tools/create-relationship.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGlE,MAAM,uBAAuB,GAAG;sBACV,CAAC;AAEvB,SAAS,oBAAoB,CAAC,IAAyB,EAAE,IAAY;IACnE,OAAO,GAAG,IAAI,sBAAsB,IAAI,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAiB,EACjB,EAAW;IAEX,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,oHAAoH;QACtH,WAAW,EAAE,6BAA6B;QAC1C,YAAY,EAAE,8BAA8B;QAC5C,WAAW,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC5D,EACD,KAAK,EAAE,MAAsB,EAAE,EAAE;QAC/B,IAAI,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;gBACxC,OAAO,mBAAmB,CACxB,WAAW,EACX,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,CAAC,CACjD,CAAC;YACJ,CAAC;YAED,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtC,OAAO,mBAAmB,CACxB,WAAW,EACX,oBAAoB,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAC/C,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,EAAE;iBACd,OAAO,CAAC,uBAAuB,CAAC;iBAChC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;YAEpE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;YAEnC,MAAM,YAAY,CAAC,MAAM,EAAE,qBAAqB,EAAE;gBAChD,QAAQ,EAAE,MAAM,CAAC,SAAS;gBAC1B,MAAM,EAAE,MAAM,CAAC,OAAO;gBACtB,YAAY,EAAE,MAAM,CAAC,aAAa;gBAClC,OAAO;aACR,CAAC,CAAC;YAEH,OAAO,kBAAkB,CAAC;gBACxB,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE;oBACN,OAAO;iBACR;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/delete-memories.d.ts

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

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

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

package/dist/tools/delete-memories.js

@@ -0,0 +1,55 @@
+import { E_UNKNOWN, getErrorMessage } from '../lib/errors.js';
+import { createErrorResponse, createToolResponse, } from '../lib/tool-response.js';
+import { DeleteMemoriesInputSchema } from '../schemas/inputs.js';
+import { BatchResultSchema } from '../schemas/outputs.js';
+import { logToolEvent, notifyMemoryResourceUpdated, withImmediateTransaction, } from './helpers.js';
+const DELETE_MEMORY_SQL = 'DELETE FROM memories WHERE hash = ?';
+function summarizeBatch(items) {
+    const succeeded = items.filter((item) => item.ok).length;
+    return { succeeded, failed: items.length - succeeded };
+}
+export function registerDeleteMemories(server, db) {
+    server.registerTool('delete_memories', {
+        title: 'Delete Memories (Batch)',
+        description: 'Delete multiple memories by hash in a single atomic transaction. Returns per-item results indicating which hashes were deleted.',
+        inputSchema: DeleteMemoriesInputSchema,
+        outputSchema: BatchResultSchema,
+        annotations: { destructiveHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            const results = withImmediateTransaction(db, () => {
+                const items = [];
+                const stmt = db.prepare(DELETE_MEMORY_SQL);
+                for (const hash of params.hashes) {
+                    const result = stmt.run(hash);
+                    items.push({
+                        hash,
+                        ok: true,
+                        created: false,
+                        deleted: result.changes > 0,
+                    });
+                }
+                return items;
+            });
+            const deleted = results.filter((r) => r.deleted).length;
+            const { succeeded, failed } = summarizeBatch(results);
+            await logToolEvent(server, 'delete_memories', {
+                total: params.hashes.length,
+                deleted,
+            });
+            for (const item of results) {
+                if (item.deleted) {
+                    await notifyMemoryResourceUpdated(server, item.hash);
+                }
+            }
+            return createToolResponse({
+                ok: true,
+                result: { items: results, succeeded, failed },
+            });
+        }
+        catch (err) {
+            return createErrorResponse(E_UNKNOWN, getErrorMessage(err));
+        }
+    });
+}
+//# sourceMappingURL=delete-memories.js.map

package/dist/tools/delete-memories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-memories.js","sourceRoot":"","sources":["../../src/tools/delete-memories.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EACL,YAAY,EACZ,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAItB,MAAM,iBAAiB,GAAG,qCAAqC,CAAC;AAEhE,SAAS,cAAc,CAAC,KAAiC;IAIvD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IACzD,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,EAAW;IACnE,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,iIAAiI;QACnI,WAAW,EAAE,yBAAyB;QACtC,YAAY,EAAE,iBAAiB;QAC/B,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC7D,EACD,KAAK,EAAE,MAA2B,EAAE,EAAE;QACpC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,wBAAwB,CAAC,EAAE,EAAE,GAAG,EAAE;gBAChD,MAAM,KAAK,GAAsB,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAU,iBAAiB,CAAC,CAAC;gBACpD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;oBAC9B,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI;wBACJ,EAAE,EAAE,IAAI;wBACR,OAAO,EAAE,KAAK;wBACd,OAAO,EAAE,MAAM,CAAC,OAAO,GAAG,CAAC;qBAC5B,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC,CAAC,CAAC;YAEH,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;YACxD,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YACtD,MAAM,YAAY,CAAC,MAAM,EAAE,iBAAiB,EAAE;gBAC5C,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;gBAC3B,OAAO;aACR,CAAC,CAAC;YAEH,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC3B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjB,MAAM,2BAA2B,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;YAED,OAAO,kBAAkB,CAAC;gBACxB,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE;aAC9C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/delete-memory.d.ts

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

package/dist/tools/delete-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-memory.d.ts","sourceRoot":"","sources":["../../src/tools/delete-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAiB9C,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAkCzE"}

package/dist/tools/delete-memory.js

@@ -0,0 +1,35 @@
+import { E_NOT_FOUND, E_UNKNOWN, getErrorMessage } from '../lib/errors.js';
+import { createErrorResponse, createToolResponse, } from '../lib/tool-response.js';
+import { DeleteMemoryInputSchema } from '../schemas/inputs.js';
+import { DeleteResultSchema } from '../schemas/outputs.js';
+import { logToolEvent, notifyMemoryResourceUpdated } from './helpers.js';
+const DELETE_MEMORY_SQL = 'DELETE FROM memories WHERE hash = ?';
+function formatMemoryNotFound(hash) {
+    return `Memory not found: ${hash}`;
+}
+export function registerDeleteMemory(server, db) {
+    server.registerTool('delete_memory', {
+        title: 'Delete Memory',
+        description: 'Delete a single memory by its SHA-256 hash. Also removes any relationships involving it.',
+        inputSchema: DeleteMemoryInputSchema,
+        outputSchema: DeleteResultSchema,
+        annotations: { destructiveHint: true, openWorldHint: false },
+    }, async (params) => {
+        try {
+            const result = db.prepare(DELETE_MEMORY_SQL).run(params.hash);
+            if (result.changes === 0) {
+                return createErrorResponse(E_NOT_FOUND, formatMemoryNotFound(params.hash));
+            }
+            await logToolEvent(server, 'delete', { hash: params.hash });
+            await notifyMemoryResourceUpdated(server, params.hash);
+            return createToolResponse({
+                ok: true,
+                result: { deleted: true, hash: params.hash },
+            });
+        }
+        catch (err) {
+            return createErrorResponse(E_UNKNOWN, getErrorMessage(err));
+        }
+    });
+}
+//# sourceMappingURL=delete-memory.js.map

package/dist/tools/delete-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-memory.js","sourceRoot":"","sources":["../../src/tools/delete-memory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,2BAA2B,EAAE,MAAM,cAAc,CAAC;AAIzE,MAAM,iBAAiB,GAAG,qCAAqC,CAAC;AAChE,SAAS,oBAAoB,CAAC,IAAY;IACxC,OAAO,qBAAqB,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,EAAW;IACjE,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,0FAA0F;QAC5F,WAAW,EAAE,uBAAuB;QACpC,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC7D,EACD,KAAK,EAAE,MAAmB,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE9D,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,mBAAmB,CACxB,WAAW,EACX,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,CAClC,CAAC;YACJ,CAAC;YAED,MAAM,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5D,MAAM,2BAA2B,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAEvD,OAAO,kBAAkB,CAAC;gBACxB,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE;aAC7C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/delete-relationship.d.ts

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

package/dist/tools/delete-relationship.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-relationship.d.ts","sourceRoot":"","sources":["../../src/tools/delete-relationship.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAqB9C,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,EAAE,EAAE,OAAO,GACV,IAAI,CAgCN"}

package/dist/tools/delete-relationship.js

@@ -0,0 +1,35 @@
+import { E_NOT_FOUND, E_UNKNOWN, getErrorMessage } from '../lib/errors.js';
+import { createErrorResponse, createToolResponse, } from '../lib/tool-response.js';
+import { DeleteRelationshipInputSchema } from '../schemas/inputs.js';
+import { DeleteRelationshipResultSchema } from '../schemas/outputs.js';
+const DELETE_RELATIONSHIP_SQL = 'DELETE FROM relationships WHERE from_hash = ? AND to_hash = ? AND relation_type = ?';
+const DELETE_RELATIONSHIP_RESULT = { deleted: true };
+function formatRelationship(params) {
+    return `${params.from_hash} -[${params.relation_type}]-> ${params.to_hash}`;
+}
+export function registerDeleteRelationship(server, db) {
+    server.registerTool('delete_relationship', {
+        title: 'Delete Relationship',
+        description: 'Remove a directed relationship between two memories.',
+        inputSchema: DeleteRelationshipInputSchema,
+        outputSchema: DeleteRelationshipResultSchema,
+        annotations: { destructiveHint: true, openWorldHint: false },
+    }, (params) => {
+        try {
+            const result = db
+                .prepare(DELETE_RELATIONSHIP_SQL)
+                .run(params.from_hash, params.to_hash, params.relation_type);
+            if (result.changes === 0) {
+                return createErrorResponse(E_NOT_FOUND, `Relationship not found: ${formatRelationship(params)}`);
+            }
+            return createToolResponse({
+                ok: true,
+                result: DELETE_RELATIONSHIP_RESULT,
+            });
+        }
+        catch (err) {
+            return createErrorResponse(E_UNKNOWN, getErrorMessage(err));
+        }
+    });
+}
+//# sourceMappingURL=delete-relationship.js.map

package/dist/tools/delete-relationship.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-relationship.js","sourceRoot":"","sources":["../../src/tools/delete-relationship.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,8BAA8B,EAAE,MAAM,uBAAuB,CAAC;AAIvE,MAAM,uBAAuB,GAC3B,qFAAqF,CAAC;AACxF,MAAM,0BAA0B,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAErD,SAAS,kBAAkB,CACzB,MAAuE;IAEvE,OAAO,GAAG,MAAM,CAAC,SAAS,MAAM,MAAM,CAAC,aAAa,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,MAAiB,EACjB,EAAW;IAEX,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,sDAAsD;QACnE,WAAW,EAAE,6BAA6B;QAC1C,YAAY,EAAE,8BAA8B;QAC5C,WAAW,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC7D,EACD,CAAC,MAAsB,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,EAAE;iBACd,OAAO,CAAC,uBAAuB,CAAC;iBAChC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;YAE/D,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;gBACzB,OAAO,mBAAmB,CACxB,WAAW,EACX,2BAA2B,kBAAkB,CAAC,MAAM,CAAC,EAAE,CACxD,CAAC;YACJ,CAAC;YAED,OAAO,kBAAkB,CAAC;gBACxB,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,0BAA0B;aACnC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-memory.d.ts

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

package/dist/tools/get-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-memory.d.ts","sourceRoot":"","sources":["../../src/tools/get-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAgB9C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CA2BtE"}

package/dist/tools/get-memory.js

@@ -0,0 +1,30 @@
+import { E_NOT_FOUND, E_UNKNOWN, getErrorMessage } from '../lib/errors.js';
+import { createErrorResponse, createToolResponse, } from '../lib/tool-response.js';
+import { parseMemoryRow } from '../lib/types.js';
+import { GetMemoryInputSchema } from '../schemas/inputs.js';
+import { MemoryResultSchema } from '../schemas/outputs.js';
+import { getMemoryRow } from './helpers.js';
+function formatMemoryNotFound(hash) {
+    return `Memory not found: ${hash}`;
+}
+export function registerGetMemory(server, db) {
+    server.registerTool('get_memory', {
+        title: 'Get Memory',
+        description: 'Retrieve a single memory by its SHA-256 hash.',
+        inputSchema: GetMemoryInputSchema,
+        outputSchema: MemoryResultSchema,
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, (params) => {
+        try {
+            const row = getMemoryRow(db, params.hash);
+            if (!row) {
+                return createErrorResponse(E_NOT_FOUND, formatMemoryNotFound(params.hash));
+            }
+            return createToolResponse({ ok: true, result: parseMemoryRow(row) });
+        }
+        catch (err) {
+            return createErrorResponse(E_UNKNOWN, getErrorMessage(err));
+        }
+    });
+}
+//# sourceMappingURL=get-memory.js.map

package/dist/tools/get-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-memory.js","sourceRoot":"","sources":["../../src/tools/get-memory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAG5C,SAAS,oBAAoB,CAAC,IAAY;IACxC,OAAO,qBAAqB,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,EAAW;IAC9D,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,+CAA+C;QAC5D,WAAW,EAAE,oBAAoB;QACjC,YAAY,EAAE,kBAAkB;QAChC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,CAAC,MAAgB,EAAE,EAAE;QACnB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;YAE1C,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,mBAAmB,CACxB,WAAW,EACX,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,CAClC,CAAC;YACJ,CAAC;YAED,OAAO,kBAAkB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-relationships.d.ts

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

package/dist/tools/get-relationships.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-relationships.d.ts","sourceRoot":"","sources":["../../src/tools/get-relationships.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAoD9C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CA4C7E"}

package/dist/tools/get-relationships.js

@@ -0,0 +1,57 @@
+import { E_NOT_FOUND, E_UNKNOWN, getErrorMessage } from '../lib/errors.js';
+import { createErrorResponse, createToolResponse, } from '../lib/tool-response.js';
+import { parseTags } from '../lib/types.js';
+import { GetRelationshipsInputSchema } from '../schemas/inputs.js';
+import { RelationshipResultSchema } from '../schemas/outputs.js';
+import { memoryExists } from './helpers.js';
+const DIRECTIONS_BY_MODE = {
+    outgoing: ['outgoing'],
+    incoming: ['incoming'],
+    both: ['outgoing', 'incoming'],
+};
+function loadRelationships(db, hash, direction) {
+    const joinCondition = direction === 'outgoing' ? 'r.to_hash = m.hash' : 'r.from_hash = m.hash';
+    const whereColumn = direction === 'outgoing' ? 'r.from_hash' : 'r.to_hash';
+    return db
+        .prepare(`SELECT r.from_hash, r.to_hash, r.relation_type, r.created_at,
+              m.hash AS linked_hash, m.content AS linked_content, m.tags AS linked_tags
+       FROM relationships r
+       JOIN memories m ON ${joinCondition}
+       WHERE ${whereColumn} = ?
+       ORDER BY r.created_at DESC`)
+        .all(hash);
+}
+export function registerGetRelationships(server, db) {
+    server.registerTool('get_relationships', {
+        title: 'Get Relationships',
+        description: 'Retrieve all relationships for a memory, with the related memory inlined. Filter by direction (outgoing | incoming | both).',
+        inputSchema: GetRelationshipsInputSchema,
+        outputSchema: RelationshipResultSchema,
+        annotations: { readOnlyHint: true, openWorldHint: false },
+    }, (params) => {
+        try {
+            if (!memoryExists(db, params.hash)) {
+                return createErrorResponse(E_NOT_FOUND, `Memory not found: ${params.hash}`);
+            }
+            const directions = DIRECTIONS_BY_MODE[params.direction];
+            const rows = directions.flatMap((direction) => loadRelationships(db, params.hash, direction));
+            const relationships = rows.map((r) => ({
+                from_hash: r.from_hash,
+                to_hash: r.to_hash,
+                relation_type: r.relation_type,
+                created_at: r.created_at,
+                linked_hash: r.linked_hash,
+                linked_content: r.linked_content,
+                linked_tags: parseTags(r.linked_tags),
+            }));
+            return createToolResponse({
+                ok: true,
+                result: { relationships, count: relationships.length },
+            });
+        }
+        catch (err) {
+            return createErrorResponse(E_UNKNOWN, getErrorMessage(err));
+        }
+    });
+}
+//# sourceMappingURL=get-relationships.js.map

package/dist/tools/get-relationships.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-relationships.js","sourceRoot":"","sources":["../../src/tools/get-relationships.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC3E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAa5C,MAAM,kBAAkB,GAGpB;IACF,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,IAAI,EAAE,CAAC,UAAU,EAAE,UAAU,CAAC;CAC/B,CAAC;AAEF,SAAS,iBAAiB,CACxB,EAAW,EACX,IAAY,EACZ,SAAgC;IAEhC,MAAM,aAAa,GACjB,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,sBAAsB,CAAC;IAC3E,MAAM,WAAW,GAAG,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC;IAC3E,OAAO,EAAE;SACN,OAAO,CACN;;;4BAGsB,aAAa;eAC1B,WAAW;kCACQ,CAC7B;SACA,GAAG,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,MAAiB,EAAE,EAAW;IACrE,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,6HAA6H;QAC/H,WAAW,EAAE,2BAA2B;QACxC,YAAY,EAAE,wBAAwB;QACtC,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE;KAC1D,EACD,CAAC,MAAmB,EAAE,EAAE;QACtB,IAAI,CAAC;YACH,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,OAAO,mBAAmB,CACxB,WAAW,EACX,qBAAqB,MAAM,CAAC,IAAI,EAAE,CACnC,CAAC;YACJ,CAAC;YAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAC5C,iBAAiB,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,CAC9C,CAAC;YAEF,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACrC,SAAS,EAAE,CAAC,CAAC,SAAS;gBACtB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,aAAa,EAAE,CAAC,CAAC,aAAa;gBAC9B,UAAU,EAAE,CAAC,CAAC,UAAU;gBACxB,WAAW,EAAE,CAAC,CAAC,WAAW;gBAC1B,cAAc,EAAE,CAAC,CAAC,cAAc;gBAChC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;aACtC,CAAC,CAAC,CAAC;YAEJ,OAAO,kBAAkB,CAAC;gBACxB,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,CAAC,MAAM,EAAE;aACvD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,mBAAmB,CAAC,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/helpers.d.ts

@@ -0,0 +1,13 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,49 @@
+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

@@ -0,0 +1 @@
+{"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"}

package/dist/tools/index.d.ts

@@ -0,0 +1,15 @@
+import { registerCreateRelationship } from './create-relationship.js';
+import { registerDeleteMemories } from './delete-memories.js';
+import { registerDeleteMemory } from './delete-memory.js';
+import { registerDeleteRelationship } from './delete-relationship.js';
+import { registerGetMemory } from './get-memory.js';
+import { registerGetRelationships } from './get-relationships.js';
+import { registerMemoryStats } from './memory-stats.js';
+import { registerRecall } from './recall.js';
+import { registerRetrieveContext } from './retrieve-context.js';
+import { registerSearchMemories } from './search-memories.js';
+import { registerStoreMemories } from './store-memories.js';
+import { registerStoreMemory } from './store-memory.js';
+import { registerUpdateMemory } from './update-memory.js';
+export declare const TOOL_REGISTRARS: readonly [typeof registerStoreMemory, typeof registerGetMemory, typeof registerUpdateMemory, typeof registerDeleteMemory, typeof registerMemoryStats, typeof registerStoreMemories, typeof registerDeleteMemories, typeof registerSearchMemories, typeof registerCreateRelationship, typeof registerDeleteRelationship, typeof registerGetRelationships, typeof registerRecall, typeof registerRetrieveContext];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,eAAO,MAAM,eAAe,iZAclB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,29 @@
+import { registerCreateRelationship } from './create-relationship.js';
+import { registerDeleteMemories } from './delete-memories.js';
+import { registerDeleteMemory } from './delete-memory.js';
+import { registerDeleteRelationship } from './delete-relationship.js';
+import { registerGetMemory } from './get-memory.js';
+import { registerGetRelationships } from './get-relationships.js';
+import { registerMemoryStats } from './memory-stats.js';
+import { registerRecall } from './recall.js';
+import { registerRetrieveContext } from './retrieve-context.js';
+import { registerSearchMemories } from './search-memories.js';
+import { registerStoreMemories } from './store-memories.js';
+import { registerStoreMemory } from './store-memory.js';
+import { registerUpdateMemory } from './update-memory.js';
+export const TOOL_REGISTRARS = [
+    registerStoreMemory,
+    registerGetMemory,
+    registerUpdateMemory,
+    registerDeleteMemory,
+    registerMemoryStats,
+    registerStoreMemories,
+    registerDeleteMemories,
+    registerSearchMemories,
+    registerCreateRelationship,
+    registerDeleteRelationship,
+    registerGetRelationships,
+    registerRecall,
+    registerRetrieveContext,
+];
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,mBAAmB;IACnB,iBAAiB;IACjB,oBAAoB;IACpB,oBAAoB;IACpB,mBAAmB;IACnB,qBAAqB;IACrB,sBAAsB;IACtB,sBAAsB;IACtB,0BAA0B;IAC1B,0BAA0B;IAC1B,wBAAwB;IACxB,cAAc;IACd,uBAAuB;CACf,CAAC"}

package/dist/tools/memory-stats.d.ts

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

package/dist/tools/memory-stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-stats.d.ts","sourceRoot":"","sources":["../../src/tools/memory-stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAmC9C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,GAAG,IAAI,CAgDxE"}