Module execution 

Execution orchestration for background agent runs.

This module provides the shared execution infrastructure used by all background execution paths: HTTP execute handler, spawn scheduler, and schedule manager.

Key types

• AgentRunner / AgentStatus — lifecycle state of an agent run
• try_reserve_runner — atomically reserve a runner slot
• finalize_runner — update runner terminal status
• create_event_forwarder — MPSC → broadcast channel forwarder
• get_or_create_event_sender — session-scoped event broadcaster
• spawn_session_execution — spawn agent execution with full orchestration

Re-exports

pub use agent_spawn::log_base_system_prompt_snapshot;

pub use agent_spawn::preserve_concurrent_session_overrides;

pub use agent_spawn::spawn_session_execution;

pub use agent_spawn::SessionExecutionArgs;

pub use event_forwarder::create_event_forwarder;

pub use runner_lifecycle::finalize_runner;

pub use runner_lifecycle::status_from_execution_result;

pub use runner_lifecycle::try_reserve_runner;

pub use runner_state::AgentRunner;

pub use runner_state::AgentStatus;

pub use session_events::get_or_create_event_sender;

pub use session_events::SESSION_EVENT_CHANNEL_CAPACITY;

pub use spawn::ExternalChildRunner;

pub use spawn::SpawnContext;

pub use spawn::SpawnJob;

pub use spawn::SpawnScheduler;

Modules

agent_spawn

Core agent execution spawning logic.

event_forwarder

Event forwarding from MPSC to broadcast channels.

runner_lifecycle

Runner lifecycle helpers for background agent execution.

runner_state

Runner state types for background agent execution.

session_events

Session-scoped event sender management.

spawn

Sub-session spawn scheduler.