Expand description
Supervisor: agent lifecycle management.
The supervisor handles forking, executing, monitoring, and terminating agent instances. It is the “init” of Oxios.
When an agent is forked and executed, the supervisor delegates
the actual tool-calling loop to the AgentRuntime.
§Agent Pool & Session Persistence
Agents are retained in an AgentPool after execution for:
- Session continuation via
Agent::continue_with()— multi-turn conversations without re-creating the agent. - State export/import — serialize agent conversation history to JSON for crash recovery, migration, or debugging.
- Provider rate limiting — all agents share a [
ProviderPool] to respect per-provider RPM/concurrency limits.
Structs§
- Agent
Pool - Pool of live
Agentinstances, keyed by AgentId. - Basic
Supervisor - Basic in-memory supervisor implementation with AgentRuntime integration.
- NoOp
Supervisor - A no-op supervisor used during KernelBuilder::build() to break the KernelHandle → AgentRuntime → Supervisor → KernelHandle cycle.
Traits§
- Supervisor
- Supervisor trait for managing agent lifecycles.