Storage
What local SQLite persists, and which recovery behaviors are not validated.
Default local storage is SQLite at .nylorun/runtime.sqlite. Keep the
database and its WAL/journal together. One process owns that file. A local PID
lock rejects concurrent owners. Shared or networked filesystems and multiple
replicas are unsupported.
| Path | Purpose | Commit it? |
|---|---|---|
.nylorun/runtime.sqlite | Checkpoints, commands, effects, canonical history. | No |
.nylorun/local-credentials.json | CLI-generated server and executor secrets (mode 0600). | No |
.nylorun/vault-kek | Host-created vault key (mode 0600) when NYLORUN_VAULT_KEK is unset. | No |
.nylorun/ host vault rows | Encrypted model credentials. | No |
sandboxes/ beside SQLite | Virtual-backend workspace files. | No |
NYLORUN_SQLITE_PATH overrides the database path for the executable server.
HOST and PORT configure the listen address (local defaults 127.0.0.1 and
8787).
Ordinary shutdown and restart keep completed session history. Restart can resume persisted runnable sessions. Model intents without recorded outcomes become uncertain and are not automatically repeated. Expired hook claims are offered again.
What this store is not
- Not a distributed SQLite or multi-replica scheduler.
- Not an automatic converter for 0.13
SessionRecord/events.jsonlroots. Those files are archive. - Not exactly-once external effects.
stepmemoizes only after a persisted action outcome. Interrupted tool work stays uncertain. - Not automatic timer or event wakeups for
sleep/waitFor. - Not a validated crash-recovery product. SDK and host methods that persist checkpoints do not by themselves prove every interrupted tool can be replayed safely.
Deleting .nylorun/ removes local history, credentials, and the vault key.