Checks if an entity exists in persistent storage by its ID. Useful for conditional operations without reading the full entity (e.g., checking session memory existence).
The identifier of the entity to check (string or number), unique within its storage context.
A promise resolving to true if the entity exists, false otherwise.
Reads an entity from persistent storage by its ID, parsing it from a JSON file. Used to retrieve persisted data such as agent states, memory, or alive status.
The identifier of the entity to read (string or number), unique within its storage context.
A promise resolving to the entity data.
Initializes the storage directory, creating it if needed and validating existing data by removing invalid entities. Ensures the persistence layer is ready for use, handling corrupt files during setup.
Indicates if this is the initial setup; affects memoization behavior for efficiency.
A promise that resolves when initialization is complete.
Writes an entity to persistent storage with the specified ID, serializing it to JSON. Uses atomic writes to ensure data integrity, critical for reliable state persistence across swarm operations.
The identifier for the entity (string or number), unique within its storage context.
The entity data to persist (e.g., { online: true } for alive status).
A promise that resolves when the write operation is complete.
Defines the core interface for persistent storage operations in the swarm system. Provides methods for managing entities stored as JSON files in the file system, used across swarm utilities.