The execution layer provides a unified set of primitives for staging workspaces,
launching runtimes, capturing filesystem changes, and bridging evaluation and
agent flows. Core modules live under src/slop_code/execution and are composed
around three building blocks:
Workspace– prepares isolated directories, restores snapshots, and exposes file-reading helpers.Session– coordinates workspace lifecycle, static assets, andSubmissionRuntimeinstances.SubmissionRuntimeimplementations – execute commands locally or inside containers while streaming output to adapters.
Use these pages to navigate the package:
- Session Lifecycle – Workspace orchestration, runtime spawning, and checkpoint handoff
- Runtime Registry –
SubmissionRuntimeprotocol and spawn helpers - Environment Specs – Pydantic models shared by all runtimes
- Local Runtime – Host-based execution details
- Docker Runtime – Container execution, networking, and setup scripts
- Static Assets – Configuration, resolution, and materialization rules
- Snapshots & Diffs – Capturing workspace state and comparing runs
- File Operations – Reading, writing, and classifying execution files
- Extending Execution – Adding new specs, runtimes, or tooling