Expand description
Record: ground-truth events for a Keel space.
Distinct from agent framework logs: these describe FS / net / exec / lifecycle as observed or enacted by Keel, always tagged with policy and space ids.
Optional hash chain integrity: see HashChainSink and verify_chain.
Structs§
- Hash
Chain Sink - Wraps an inner sink and seals each event into a SHA-256 hash chain.
- Jsonl
Sink - Append-only JSONL file sink.
- Memory
Sink - In-memory sink for tests and demos.
- Multi
Sink - Fan-out sink.
- Record
Event
Enums§
- Chain
Verify Error - Result of verifying a sequence of chained events.
- Event
Kind
Constants§
- GENESIS_
PREV - Genesis previous-hash for the first event in a chain.
Traits§
Functions§
- compute_
event_ hash - Compute SHA-256 hex of the canonical hash body for an event.
- content_
sha256 - SHA-256 hex of arbitrary bytes (e.g. file contents written via SpaceFs).
- default_
space_ sink - Create the default on-disk JSONL sink for a space
(
~/.keel/spaces/<id>/events.jsonl). - keel_
home - Keel state directory (
$KEEL_HOMEor~/.keel). - keel_
tmp_ dir - Ephemeral dir for spawn-time policy files.
- seal_
event - Attach
prev_hash+event_hashusing the previous hash in the chain. - space_
dir - Directory for one space:
~/.keel/spaces/<id>/. - space_
events_ path - Default event log path:
~/.keel/spaces/<id>/events.jsonl. - space_
policy_ path - Optional persisted policy snapshot path.
- verify_
chain - Verify an ordered event list forms a valid hash chain.
- verify_
jsonl - Load JSONL from a string and verify the chain.