Package Exports
- @loomfsm/kernel
- @loomfsm/kernel/internal
- @loomfsm/kernel/package.json
Readme
@loomfsm/kernel
The finite-state-machine kernel underneath loom: the state machine, commit-time safety
invariants, the idempotency ledger, the gate-policy engine, and the plugin contracts that
providers, transports, and bundles implement. Zero runtime dependencies — persistence
rides on Node's built-in node:sqlite. The kernel is domain-blind: it contains no vendor,
model, or transport names (enforced by CI), so a new domain is a new bundle and the kernel
never changes.
What's inside
- Atomic state — every step commits through a SQLite transaction; invariants run inside it and roll it back on violation, so an unsafe state never exists.
- Idempotency ledger — every effect's ledger row is committed in the same transaction as the state change it dedupes; crash recovery is "restart and replay".
- Replay determinism — one timestamp token captured per tick and threaded through every call; the same (state, timestamp, ledger) yields the same trajectory.
- Gate policies —
human/on-blockers/auto, dispatched as functions, not switches. - Plugin contracts — the typed surfaces bundles, providers, and transports implement.
Runtime requirement
@loomfsm/kernel imports node:sqlite. On Node 22.x that module is behind a runtime
flag, so any process that loads the kernel must pass it:
node --experimental-sqlite your-entry.js
node --experimental-sqlite --no-warnings --test # node:test, warning silencednode:sqlite is unflagged on Node 23+ and stable on Node 24+; the flag is a
harmless no-op there.
Install
pnpm add @loomfsm/kernelPart of loom
loom drives multi-step LLM agent work — code review, implementation, any review-gated task — as a replay-deterministic state machine: safety invariants enforced at commit time, human gates where they matter, and a complete, replayable audit trail in a local SQLite file.
Most users should install @loomfsm/pipeline
(npm i -g @loomfsm/pipeline), which pulls the whole runtime in one step. Install this
package directly only if you are assembling your own runtime.
Website · Quickstart · Why loom · GitHub
License
Apache-2.0