Expand description
Keel core: bind a Policy to an EnforceBackend and a RecordSink
as a durable execution space.
Structs§
- Backend
Info - Credential
Grant - Just-in-time credential handle (opaque to the agent; injected by Keel).
- FsRule
- A single filesystem rule.
- Jsonl
Sink - Append-only JSONL file sink.
- Local
Process Backend - Landlock / Seatbelt enforce backend.
- Local
Process Options - Options for
LocalProcessBackend. - Memory
Sink - In-memory sink for tests and demos.
- Multi
Sink - Fan-out sink.
- Network
Rule - Null
Backend - Policy
- Bound execution policy. Immutable after space creation (v0).
- Policy
Builder - Policy
Id - Process
Guard Backend - Record
Event - Sandbox
Config - Merged view of global + project sandbox config.
- Space
- Live execution space: one policy, one backend, one record stream.
- Space
Handle - Public handle returned after create.
- SpaceId
- Space
Options - Options for opening a space.
- Spawn
Request - Spawned
Process - TaskId
- Task
Spec - Requested changes when forking a space for a subtask.
- Worktree
Backend - Worktree isolation backend (optionally layered on another backend).
- Worktree
Options - Options for
WorktreeBackend.
Enums§
- Egress
Decision - Result of an egress decision.
- Event
Kind - Exec
Policy - Whether the agent may spawn subprocesses / shells.
- FsAccess
- How a path may be accessed.
- Keel
Error - Network
Policy - Network reach for the execution space.
- Space
State
Traits§
- Enforce
Backend - A live enforcement context for one space.
- Record
Sink
Functions§
- apply_
policy_ file_ and_ ready - Load policy JSON from path and apply (used by
keel sandbox-exec). - backend_
local_ process - Local-process only (no worktree).
- backend_
process_ guard - Soft process-guard only.
- check_
egress - Evaluate whether a dial to
host:portis permitted. - 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). - load_
policy_ from_ sandbox_ toml - Load config for workspace and resolve a profile name.
- narrow_
policy - Build a child policy from
parent+spec. Fails if the child would expand reach. - prepare_
kernel - Validate that the policy can be mapped and the platform supports sandboxing.
- profile_
read_ only - Explore without modifying the project tree. Writes only to keel home + temps.
- profile_
strict - Narrower reach: no default world-read; workspace + essential system paths only.
- profile_
workspace - Everyday coding: broad read, write limited to workspace + keel home + temps.
- resolve_
policy_ with_ files - Resolve policy: optional explicit file path overrides name lookup.
- 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.
- worktree_
sandboxed - Worktree + LocalProcess (kernel FS on children) — closest to Grok’s “isolated tree + OS sandbox” stack for coding agents.
- worktree_
soft - Worktree isolation only (soft process-guard inside).