Reference

The reference tier is the contract: precise, terse, and stable. It is the companion to the concepts, which explain why each piece is shaped the way it is.

The Rib contractThe Rib interface, the context the harness injects, the validation rules it enforces, and the activation lifecycle.

Workflow nodesThe seven node kinds, the fields every node shares, the substitution model, and the loader's rules.

Snapshots and the canvasThe SnapshotManager interface, the frame wire shape, and the closed canvas vocabulary a payload must satisfy.

The CLIThe keelson command tree, the global flags, the JSON envelope, and the stable exit-code contract.

ProvidersThe IAgentProvider interface, the capability shape, and the matrix of what each built-in provider supports.

The HTTP and WS APIThe server's local API surface grouped by resource, the WebSocket streams, and the conventions a client relies on.

DirectoriesHow the keelson home is resolved, what lives inside it, and the variables that relocate each piece.

TroubleshootingThe common failure modes, what causes each, and the fix, anchored on the doctor health sweep.