@sylphlab/tools-memory NPM

@sylphlab/tools-memory

Core logic and tool definitions for Knowledge Graph memory management based on a Property Graph model.

Overview

This package provides the core functionalities for interacting with a knowledge graph used for AI agent memory, stored in a memory.jsonl file. It utilizes a Property Graph model where data is represented as Nodes (with IDs, labels, and key-value properties) and Edges (with type, from/to node IDs, and optional properties).

It defines individual tools (like create_nodes, find_nodes, update_node_properties, etc.) following the @sylphlab/tools-core structure. File I/O operations are handled internally by graphUtils.ts.

The actual MCP server implementation is handled by @sylphlab/tools-memory-mcp, which uses this package.

Features

Property Graph Model: Represents knowledge using Nodes (entities) and Edges (relations), both supporting key-value properties.
JSON Lines Storage: Reads from and writes to a memory.jsonl file, making it version-control friendly.
Comprehensive Toolset: Exports standardized tool objects (ToolDefinition from @sylphlab/tools-core) for:
- Node CRUD: create_nodes, get_node, update_node_properties, replace_node_properties, add_node_labels, remove_node_labels, delete_nodes.
- Edge CRUD: create_edges, update_edge_properties, replace_edge_properties, delete_edges. (Note: Edge updates/deletes currently rely on generated IDs).
- Querying & Discovery: find_nodes (flexible search), list_nodes (by type or all, with pagination), find_related_nodes (graph traversal), list_labels, list_relation_types.
UUID Identifiers: Nodes and Edges use UUIDs for unique identification.