taerae_core library

In-memory graph primitives, GraphRAG helpers, and persistence utilities.

This library provides TaeraeGraph for graph mutations and traversal, immutable graph entities such as TaeraeNode and TaeraeEdge, GraphRAG components such as TaeraeGraphRag, and file-backed durability through TaeraePersistentGraph.

final graph = TaeraeGraph();
graph.upsertNode('u1', labels: <String>{'User'});
graph.upsertNode('u2', labels: <String>{'User'});
graph.upsertEdge('f1', 'u1', 'u2', type: 'follows');

final path = graph.shortestPathBfs('u1', 'u2');

Classes

TaeraeDurabilityOptions
Durability settings for TaeraePersistentGraph.
TaeraeEdge
Immutable directed graph edge.
TaeraeFixedSizeTextChunker
Fixed-size character chunker.
TaeraeGraph
Lightweight in-memory graph engine.
TaeraeGraphLog
Append-only NDJSON log for graph mutation operations.
TaeraeGraphOperation
Serializable graph mutation operation for append-only persistence.
TaeraeGraphRag
Lightweight GraphRAG helper built on TaeraeGraph.
TaeraeGraphRagFilter
Optional node-level filter for GraphRAG retrieval.
TaeraeGraphRagHit
Retrieval result with graph context.
TaeraeGraphReranker
Hook interface for re-ranking retrieval hits.
TaeraeGraphSnapshotStore
Snapshot read/write utility for graph persistence.
TaeraeInMemoryVectorIndex
In-memory cosine-similarity vector index.
TaeraeNode
Immutable graph node.
TaeraePersistentGraph
File-backed graph wrapper using append-only logs plus periodic snapshots.
TaeraeScoredNode
Search result item for vector similarity lookup.
TaeraeTextChunker
Text chunking strategy for GraphRAG indexing.
TaeraeTextEmbedder
Interface for generating vector embeddings from text.
TaeraeVectorIndex
Interface for node-vector indexing used by GraphRAG retrieval.

Enums

TaeraeGraphOperationType
Operation kinds persisted in the append-only graph log.
TaeraeLogFlushPolicy
Log flush strategy for append-only writes.
TaeraeWriteAtomicityPolicy
Ordering policy for memory-vs-log mutation commit.