Skip to main content

Module supervisor

Module supervisor 

Source
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§

AgentPool
Pool of live Agent instances, keyed by AgentId.
BasicSupervisor
Basic in-memory supervisor implementation with AgentRuntime integration.
NoOpSupervisor
A no-op supervisor used during KernelBuilder::build() to break the KernelHandle → AgentRuntime → Supervisor → KernelHandle cycle.

Traits§

Supervisor
Supervisor trait for managing agent lifecycles.