@datafrog-io/n2n-memory 1.0.2 → 1.1.0

package/build/core/memory-service.js

@@ -0,0 +1,340 @@
+import { Mutex } from "async-mutex";
+import lockfile from "proper-lockfile";
+import fs from "fs-extra";
+import path from "path";
+import { MemoryManager, MEMORY_FILE_PATH, CONTEXT_FILE_PATH } from "./memory-manager.js";
+/**
+ * MemoryService - High reliability dual-buffer memory manager.
+ * - Snapshot Buffer: Instant in-memory reads for both Graph and Context.
+ * - Write Queue: Sequentialized, atomic writes with independent cross-process locking for Graph and Context.
+ */
+export class MemoryService {
+    static instance;
+    // Graph state
+    snapshots = new Map();
+    writeMutexes = new Map();
+    lastMtimes = new Map();
+    // Context state (Hot data)
+    contextSnapshots = new Map();
+    contextMutexes = new Map();
+    contextMtimes = new Map();
+    // Resource Management
+    activeLocks = new Map();
+    projectAccessOrder = [];
+    MAX_PROJECTS = 20;
+    constructor() { }
+    static getInstance() {
+        if (!MemoryService.instance) {
+            MemoryService.instance = new MemoryService();
+        }
+        return MemoryService.instance;
+    }
+    /** @internal */
+    static resetInstance() {
+        MemoryService.instance = new MemoryService();
+    }
+    /**
+     * Gracefully shuts down the service, releasing all active file locks.
+     */
+    async shutdown() {
+        console.error(`[MemoryService] Shutting down, releasing ${this.activeLocks.size} locks...`);
+        const lockReleases = Array.from(this.activeLocks.values());
+        await Promise.all(lockReleases.map(release => release().catch(() => { })));
+        this.activeLocks.clear();
+    }
+    /**
+     * Simple LRU pruning to prevent memory growth.
+     */
+    touchProject(projectPath) {
+        this.projectAccessOrder = this.projectAccessOrder.filter(p => p !== projectPath);
+        this.projectAccessOrder.push(projectPath);
+        if (this.projectAccessOrder.length > this.MAX_PROJECTS) {
+            const oldest = this.projectAccessOrder.shift();
+            if (oldest) {
+                this.snapshots.delete(oldest);
+                this.lastMtimes.delete(oldest);
+                this.contextSnapshots.delete(oldest);
+                this.contextMtimes.delete(oldest);
+                this.writeMutexes.delete(oldest);
+                this.contextMutexes.delete(oldest);
+            }
+        }
+    }
+    getMutex(projectPath) {
+        if (!this.writeMutexes.has(projectPath)) {
+            this.writeMutexes.set(projectPath, new Mutex());
+        }
+        return this.writeMutexes.get(projectPath);
+    }
+    getContextMutex(projectPath) {
+        if (!this.contextMutexes.has(projectPath)) {
+            this.contextMutexes.set(projectPath, new Mutex());
+        }
+        return this.contextMutexes.get(projectPath);
+    }
+    // --- Graph Operations ---
+    async loadSnapshot(projectPath) {
+        this.touchProject(projectPath);
+        const filePath = path.resolve(projectPath, MEMORY_FILE_PATH);
+        try {
+            if (await fs.pathExists(filePath)) {
+                const stats = await fs.stat(filePath);
+                const currentMtime = stats.mtimeMs;
+                if (this.snapshots.has(projectPath) && this.lastMtimes.get(projectPath) === currentMtime) {
+                    return this.snapshots.get(projectPath);
+                }
+                const graph = await MemoryManager.readGraph(projectPath);
+                this.snapshots.set(projectPath, graph);
+                this.lastMtimes.set(projectPath, currentMtime);
+                return graph;
+            }
+        }
+        catch (error) {
+            console.error(`[MemoryService] Failed to load graph snapshot: ${error}`);
+        }
+        const emptyGraph = { entities: [], relations: [] };
+        this.snapshots.set(projectPath, emptyGraph);
+        return emptyGraph;
+    }
+    async getGraph(projectPath) {
+        if (!this.snapshots.has(projectPath)) {
+            return await this.loadSnapshot(projectPath);
+        }
+        return this.snapshots.get(projectPath);
+    }
+    // --- Context Operations ---
+    async loadContextSnapshot(projectPath) {
+        this.touchProject(projectPath);
+        const filePath = path.resolve(projectPath, CONTEXT_FILE_PATH);
+        try {
+            if (await fs.pathExists(filePath)) {
+                const stats = await fs.stat(filePath);
+                const currentMtime = stats.mtimeMs;
+                if (this.contextSnapshots.has(projectPath) && this.contextMtimes.get(projectPath) === currentMtime) {
+                    return this.contextSnapshots.get(projectPath);
+                }
+                const context = await MemoryManager.readContext(projectPath);
+                this.contextSnapshots.set(projectPath, context);
+                this.contextMtimes.set(projectPath, currentMtime);
+                return context;
+            }
+        }
+        catch (error) {
+            console.error(`[MemoryService] Failed to load context snapshot: ${error}`);
+        }
+        const defaultContext = { status: "PLANNING", nextSteps: [] };
+        this.contextSnapshots.set(projectPath, defaultContext);
+        return defaultContext;
+    }
+    async getContext(projectPath) {
+        if (!this.contextSnapshots.has(projectPath)) {
+            return await this.loadContextSnapshot(projectPath);
+        }
+        return this.contextSnapshots.get(projectPath);
+    }
+    /**
+     * Updates project context with independent locking.
+     */
+    async updateContext(projectPath, update) {
+        const mutex = this.getContextMutex(projectPath);
+        const filePath = path.resolve(projectPath, CONTEXT_FILE_PATH);
+        const dirPath = path.dirname(filePath);
+        await mutex.runExclusive(async () => {
+            await fs.ensureDir(dirPath);
+            const fileExists = await fs.pathExists(filePath);
+            let release;
+            try {
+                if (fileExists) {
+                    release = await lockfile.lock(filePath, { retries: 5 });
+                }
+                else {
+                    release = await lockfile.lock(dirPath, { retries: 5 });
+                }
+                this.activeLocks.set(filePath, release);
+                const currentContext = await MemoryManager.readContext(projectPath);
+                const updatedContext = { ...currentContext, ...update };
+                await MemoryManager.writeContext(projectPath, updatedContext);
+                // Update local snapshot
+                const stats = await fs.stat(filePath);
+                this.contextMtimes.set(projectPath, stats.mtimeMs);
+                this.contextSnapshots.set(projectPath, updatedContext);
+            }
+            finally {
+                if (release) {
+                    this.activeLocks.delete(filePath);
+                    await release();
+                }
+            }
+        });
+    }
+    // --- Combined Operations ---
+    async getCompleteState(projectPath, options = {}) {
+        const [graph, context] = await Promise.all([
+            this.getGraph(projectPath),
+            this.getContext(projectPath)
+        ]);
+        const totalEntityCount = graph.entities.length;
+        const offset = options.offset || 0;
+        const limit = options.limit || totalEntityCount;
+        const paginatedEntities = graph.entities.slice(offset, offset + limit);
+        const isTruncated = (offset + limit) < totalEntityCount;
+        const entities = options.summaryMode
+            ? paginatedEntities.map(e => ({ name: e.name, entityType: e.entityType, observations: [] }))
+            : paginatedEntities;
+        // Filter relations to only include those where BOTH nodes are in the current page
+        // to maintain UI/Logic consistency during paginated reading.
+        const entityNameSet = new Set(paginatedEntities.map(e => e.name));
+        const relations = graph.relations.filter(r => entityNameSet.has(r.from) && entityNameSet.has(r.to));
+        return {
+            graph: { entities, relations },
+            context,
+            totalEntityCount,
+            isTruncated
+        };
+    }
+    async getGraphSummary(projectPath, options = {}) {
+        const graph = await this.getGraph(projectPath);
+        const totalEntityCount = graph.entities.length;
+        const offset = options.offset || 0;
+        const limit = options.limit || totalEntityCount;
+        const paginated = graph.entities.slice(offset, offset + limit);
+        const isTruncated = (offset + limit) < totalEntityCount;
+        return {
+            entities: paginated.map(e => ({ name: e.name, type: e.entityType })),
+            relationCount: graph.relations.length,
+            totalEntityCount,
+            isTruncated
+        };
+    }
+    // --- Mutation Helpers ---
+    async executeWrite(projectPath, updateFn) {
+        const mutex = this.getMutex(projectPath);
+        const filePath = path.resolve(projectPath, MEMORY_FILE_PATH);
+        const dirPath = path.dirname(filePath);
+        await mutex.runExclusive(async () => {
+            await fs.ensureDir(dirPath);
+            const fileExists = await fs.pathExists(filePath);
+            let release;
+            try {
+                if (fileExists) {
+                    release = await lockfile.lock(filePath, { retries: 5 });
+                }
+                else {
+                    release = await lockfile.lock(dirPath, { retries: 5 });
+                }
+                this.activeLocks.set(filePath, release);
+                const currentGraph = await MemoryManager.readGraph(projectPath);
+                updateFn(currentGraph);
+                await MemoryManager.writeGraph(projectPath, currentGraph);
+                const stats = await fs.stat(filePath);
+                this.lastMtimes.set(projectPath, stats.mtimeMs);
+                this.snapshots.set(projectPath, currentGraph);
+            }
+            catch (error) {
+                console.error(`[MemoryService] Write operation failed for ${projectPath}:`, error);
+                throw error;
+            }
+            finally {
+                if (release) {
+                    this.activeLocks.delete(filePath);
+                    await release();
+                }
+            }
+        });
+    }
+    async addEntities(projectPath, entities) {
+        await this.executeWrite(projectPath, (graph) => {
+            entities.forEach(newEntity => {
+                const existing = graph.entities.find(e => e.name === newEntity.name);
+                if (existing) {
+                    existing.observations = Array.from(new Set([...existing.observations, ...newEntity.observations]));
+                }
+                else {
+                    graph.entities.push(newEntity);
+                }
+            });
+        });
+    }
+    async addObservations(projectPath, observations) {
+        let count = 0;
+        await this.executeWrite(projectPath, (graph) => {
+            observations.forEach(obs => {
+                const entity = graph.entities.find(e => e.name === obs.entityName);
+                if (entity) {
+                    const originalLen = entity.observations.length;
+                    entity.observations = Array.from(new Set([...entity.observations, ...obs.contents]));
+                    count += entity.observations.length - originalLen;
+                }
+            });
+        });
+        return count;
+    }
+    async createRelations(projectPath, relations) {
+        await this.executeWrite(projectPath, (graph) => {
+            relations.forEach(newRel => {
+                const exists = graph.relations.some(r => r.from === newRel.from && r.to === newRel.to && r.relationType === newRel.relationType);
+                if (!exists) {
+                    graph.relations.push(newRel);
+                }
+            });
+        });
+    }
+    async deleteEntities(projectPath, entityNames) {
+        let count = 0;
+        await this.executeWrite(projectPath, (graph) => {
+            const namesToDelete = new Set(entityNames);
+            const originalLen = graph.entities.length;
+            graph.entities = graph.entities.filter(e => !namesToDelete.has(e.name));
+            graph.relations = graph.relations.filter(r => !namesToDelete.has(r.from) && !namesToDelete.has(r.to));
+            count = originalLen - graph.entities.length;
+        });
+        return count;
+    }
+    async deleteObservations(projectPath, deletions) {
+        let count = 0;
+        await this.executeWrite(projectPath, (graph) => {
+            deletions.forEach(del => {
+                const entity = graph.entities.find(e => e.name === del.entityName);
+                if (entity) {
+                    const obsToDelete = new Set(del.observations);
+                    const originalLen = entity.observations.length;
+                    entity.observations = entity.observations.filter(o => !obsToDelete.has(o));
+                    count += originalLen - entity.observations.length;
+                }
+            });
+        });
+        return count;
+    }
+    async deleteRelations(projectPath, relations) {
+        let count = 0;
+        await this.executeWrite(projectPath, (graph) => {
+            const originalLen = graph.relations.length;
+            graph.relations = graph.relations.filter(r => !relations.some(del => del.from === r.from && del.to === r.to && del.relationType === r.relationType));
+            count = originalLen - graph.relations.length;
+        });
+        return count;
+    }
+    async search(projectPath, query, options = {}) {
+        const graph = await this.getGraph(projectPath);
+        const lowerQuery = query.toLowerCase();
+        const filteredEntities = graph.entities.filter(e => e.name.toLowerCase().includes(lowerQuery) ||
+            e.entityType.toLowerCase().includes(lowerQuery) ||
+            e.observations.some(o => o.toLowerCase().includes(lowerQuery)));
+        const totalResults = filteredEntities.length;
+        const offset = options.offset || 0;
+        const limit = options.limit || totalResults;
+        const paginatedEntities = filteredEntities.slice(offset, offset + limit);
+        const isTruncated = (offset + limit) < totalResults;
+        const entityNames = new Set(paginatedEntities.map(e => e.name));
+        const filteredRelations = graph.relations.filter(r => r.from.toLowerCase().includes(lowerQuery) ||
+            r.to.toLowerCase().includes(lowerQuery) ||
+            r.relationType.toLowerCase().includes(lowerQuery) ||
+            (entityNames.has(r.from) || entityNames.has(r.to)));
+        return {
+            graph: { entities: paginatedEntities, relations: filteredRelations },
+            totalResults,
+            isTruncated
+        };
+    }
+}
+//# sourceMappingURL=memory-service.js.map

package/build/core/memory-service.js.map

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

package/build/handlers/mcp-handlers.js

@@ -0,0 +1,258 @@
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
+import { TOOL_DEFINITIONS } from "../tools/definitions.js";
+import * as Schemas from "../tools/schemas.js";
+import { MemoryService } from "../core/memory-service.js";
+import { MemoryManager } from "../core/memory-manager.js";
+import { findProjectRoot } from "../utils/path-utils.js";
+import { z } from "zod";
+/**
+ * Handlers object containing the core logic for each tool/resource.
+ */
+export const Handlers = {
+    /**
+     * Handles the Project Root Handshake.
+     * Strictly enforces that memory is only initialized at project roots.
+     */
+    async resolveRootWithHandshake(args) {
+        const { projectPath, confirmNewProjectRoot } = args;
+        let discovery;
+        try {
+            discovery = await findProjectRoot(projectPath);
+        }
+        catch (error) {
+            // Strict rejection for non-project folders
+            return {
+                content: [{
+                        type: "text",
+                        text: error instanceof Error ? error.message : String(error)
+                    }],
+                isError: true
+            };
+        }
+        if (discovery.hasMcp) {
+            return discovery.rootPath;
+        }
+        // New project initialization
+        if (confirmNewProjectRoot === discovery.rootPath) {
+            return discovery.rootPath;
+        }
+        // Handshake required for recognized projects that lack .mcp
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        status: "AWAITING_CONFIRMATION",
+                        detectedRoot: discovery.rootPath,
+                        markersFound: discovery.markersFound,
+                        message: `N2N-Memory detected a valid project root at [${discovery.rootPath}]. ` +
+                            `To initialize memory for this project, please call the tool again and include the 'confirmNewProjectRoot' parameter set to the 'detectedRoot' path above.`
+                    }, null, 2)
+                }],
+            isError: true
+        };
+    },
+    async addEntities(args) {
+        const parsed = Schemas.AddEntitiesSchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        await MemoryService.getInstance().addEntities(root, parsed.entities);
+        return { content: [{ type: "text", text: `Success: Added ${parsed.entities.length} entities to root: ${root}` }] };
+    },
+    async addObservations(args) {
+        const parsed = Schemas.AddObservationsSchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        const addedCount = await MemoryService.getInstance().addObservations(root, parsed.observations);
+        return { content: [{ type: "text", text: `Success: Added ${addedCount} observation fragments to root: ${root}` }] };
+    },
+    async createRelations(args) {
+        const parsed = Schemas.CreateRelationsSchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        await MemoryService.getInstance().createRelations(root, parsed.relations);
+        return { content: [{ type: "text", text: `Success: Created ${parsed.relations.length} relations in root: ${root}` }] };
+    },
+    async readGraph(args) {
+        const parsed = Schemas.ReadGraphSchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        const state = await MemoryService.getInstance().getCompleteState(root, {
+            summaryMode: parsed.summaryMode,
+            limit: parsed.limit,
+            offset: parsed.offset
+        });
+        return { content: [{ type: "text", text: JSON.stringify(state, null, 2) }] };
+    },
+    async getGraphSummary(args) {
+        const parsed = Schemas.GetGraphSummarySchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        const result = await MemoryService.getInstance().getGraphSummary(root, {
+            limit: parsed.limit,
+            offset: parsed.offset
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    },
+    async updateContext(args) {
+        const parsed = Schemas.UpdateContextSchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        const { projectPath: _, confirmNewProjectRoot: __, ...updates } = parsed;
+        await MemoryService.getInstance().updateContext(root, updates);
+        return { content: [{ type: "text", text: `Success: Project context (hot-state) updated for root: ${root}` }] };
+    },
+    async search(args) {
+        const parsed = Schemas.SearchSchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        const result = await MemoryService.getInstance().search(root, parsed.query, {
+            limit: parsed.limit,
+            offset: parsed.offset
+        });
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    },
+    async deleteEntities(args) {
+        const parsed = Schemas.DeleteEntitiesSchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        const deletedCount = await MemoryService.getInstance().deleteEntities(root, parsed.entityNames);
+        return { content: [{ type: "text", text: `Success: Deleted ${deletedCount} entities from root: ${root}` }] };
+    },
+    async deleteObservations(args) {
+        const parsed = Schemas.DeleteObservationsSchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        const deletedCount = await MemoryService.getInstance().deleteObservations(root, parsed.deletions);
+        return { content: [{ type: "text", text: `Success: Deleted ${deletedCount} observations from root: ${root}` }] };
+    },
+    async deleteRelations(args) {
+        const parsed = Schemas.DeleteRelationsSchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        const deletedCount = await MemoryService.getInstance().deleteRelations(root, parsed.relations);
+        return { content: [{ type: "text", text: `Success: Deleted ${deletedCount} relations from root: ${root}` }] };
+    },
+    async openNodes(args) {
+        const parsed = Schemas.OpenNodesSchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        const result = await MemoryManager.openNodes(root, parsed.names);
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    },
+    async exportMarkdown(args) {
+        const parsed = Schemas.ExportMarkdownSchema.parse(args);
+        const root = await this.resolveRootWithHandshake(parsed);
+        if (typeof root !== 'string')
+            return root;
+        const filePath = await MemoryManager.exportToMarkdown(root, parsed.outputPath);
+        return { content: [{ type: "text", text: `Success: Exported knowledge graph to ${filePath}` }] };
+    },
+    async readResource(uriString) {
+        const uri = new URL(uriString);
+        if (uri.protocol !== "mcp:" || uri.host !== "memory") {
+            throw new McpError(ErrorCode.InvalidRequest, `Unknown resource URI: ${uriString}`);
+        }
+        const projectPath = uri.searchParams.get("path");
+        if (!projectPath) {
+            throw new McpError(ErrorCode.InvalidParams, "projectPath query parameter 'path' is required");
+        }
+        // Resources are tricky since they don't take extra arguments.
+        // We assume resource reading is for established projects.
+        const discovery = await findProjectRoot(projectPath);
+        if (!discovery.hasMcp) {
+            throw new McpError(ErrorCode.InvalidRequest, "Handshake required for new projects. Use tools first.");
+        }
+        const state = await MemoryService.getInstance().getCompleteState(discovery.rootPath);
+        return {
+            contents: [{
+                    uri: uriString,
+                    mimeType: "application/json",
+                    text: JSON.stringify(state, null, 2),
+                }]
+        };
+    },
+    async callTool(name, args) {
+        try {
+            switch (name) {
+                case "n2n_add_entities": return await this.addEntities(args);
+                case "n2n_add_observations": return await this.addObservations(args);
+                case "n2n_create_relations": return await this.createRelations(args);
+                case "n2n_read_graph": return await this.readGraph(args);
+                case "n2n_get_graph_summary": return await this.getGraphSummary(args);
+                case "n2n_update_context": return await this.updateContext(args);
+                case "n2n_search": return await this.search(args);
+                case "n2n_delete_entities": return await this.deleteEntities(args);
+                case "n2n_delete_observations": return await this.deleteObservations(args);
+                case "n2n_delete_relations": return await this.deleteRelations(args);
+                case "n2n_open_nodes": return await this.openNodes(args);
+                case "n2n_export_markdown": return await this.exportMarkdown(args);
+                default: throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Validation Error: ${error.issues.map(i => `${i.path.join('.')}: ${i.message}`).join(', ')}`
+                        }],
+                    isError: true,
+                };
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            if (message.startsWith("Directory Not Recognized as a Project")) {
+                return {
+                    content: [{ type: "text", text: `Project Requirement Error: ${message}` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [{ type: "text", text: `Execution Error: ${message}` }],
+                isError: true,
+            };
+        }
+    },
+    async listResources() {
+        return {
+            resources: [{
+                    uri: "mcp://memory/graph",
+                    name: "Project Knowledge Graph & Context",
+                    description: "The complete knowledge graph and active project context.",
+                    mimeType: "application/json",
+                }]
+        };
+    },
+    async listTools() {
+        return { tools: TOOL_DEFINITIONS };
+    }
+};
+/**
+ * Registers all tools and resources to the provided McpServer instance.
+ */
+export function registerAll(server) {
+    server.tool("n2n_add_entities", Schemas.AddEntitiesSchema.shape, (args) => Handlers.addEntities(args));
+    server.tool("n2n_add_observations", Schemas.AddObservationsSchema.shape, (args) => Handlers.addObservations(args));
+    server.tool("n2n_create_relations", Schemas.CreateRelationsSchema.shape, (args) => Handlers.createRelations(args));
+    server.tool("n2n_read_graph", Schemas.ReadGraphSchema.shape, (args) => Handlers.readGraph(args));
+    server.tool("n2n_get_graph_summary", Schemas.GetGraphSummarySchema.shape, (args) => Handlers.getGraphSummary(args));
+    server.tool("n2n_update_context", Schemas.UpdateContextSchema.shape, (args) => Handlers.updateContext(args));
+    server.tool("n2n_search", Schemas.SearchSchema.shape, (args) => Handlers.search(args));
+    server.tool("n2n_delete_entities", Schemas.DeleteEntitiesSchema.shape, (args) => Handlers.deleteEntities(args));
+    server.tool("n2n_delete_observations", Schemas.DeleteObservationsSchema.shape, (args) => Handlers.deleteObservations(args));
+    server.tool("n2n_delete_relations", Schemas.DeleteRelationsSchema.shape, (args) => Handlers.deleteRelations(args));
+    server.tool("n2n_open_nodes", Schemas.OpenNodesSchema.shape, (args) => Handlers.openNodes(args));
+    server.tool("n2n_export_markdown", Schemas.ExportMarkdownSchema.shape, (args) => Handlers.exportMarkdown(args));
+    server.resource("graph", "mcp://memory/graph", (uri) => Handlers.readResource(uri.href));
+}
+//# sourceMappingURL=mcp-handlers.js.map

package/build/handlers/mcp-handlers.js.map

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