Runtime Overview
The Waxell Runtime is the execution engine that brings your SDK-defined agents to life. It handles execution context, durability, and pluggable backends.
Core Responsibilities
- Execution Context: Manages state during workflow execution
- Durability: Checkpoint and resume for long-running workflows
- Backend Abstraction: Pluggable backends for different environments
- Governance Hooks: Integration points for policy enforcement
Key Abstractions
| Concept | Purpose |
|---|---|
RuntimeConfig | DI container for backend configuration |
ExecutionContext | Pure execution state management |
WorkflowEnvelope | Execution boundary with checkpoint/resume |
Step | Durable execution unit |
Local vs Production
The runtime provides different backends for different environments:
# Local development (in-memory, no external dependencies)
from waxell_runtime import RuntimeConfig
config = RuntimeConfig.get() # Uses defaults
# Production (Redis, Celery, Django)
# Automatically configured by waxell-infra Django app
Next Steps
- ExecutionContext - Understand execution state
- WorkflowEnvelope - Learn about durability
- Backends - Configure production backends