Struct Scheduler 

pub struct Scheduler { /* private fields */ }

Tokio-based scheduler that fires prompt submissions on a cron-like interval.

The scheduler holds a collection of ScheduledPrompts and a sender end of the pipeline’s input channel. Call Scheduler::spawn to start the background task.

The scheduler checks the current wall-clock time once per minute and fires every matching prompt.

Thread Safety

Scheduler is Send + Sync and is typically shared as Arc<Scheduler>. The internal prompt list is guarded by a [RwLock] so that prompts can be added and removed without stopping the background task.

Implementations

impl Scheduler

pub fn new(tx: Sender<PromptRequest>) -> Self

Create a new Scheduler that submits prompts on tx.

Panics

This function does not panic.

pub async fn add( &self, prompt: ScheduledPrompt, ) -> Result<String, OrchestratorError>

Register a ScheduledPrompt.

Returns the assigned id (a UUID v4 string) so callers can reference it later with Scheduler::remove or through the web API.

Errors

Returns OrchestratorError::ConfigError if the prompt is disabled and thus would never fire. Disabled prompts can be added — they are accepted but will not emit requests until re-enabled (e.g. via the web API).

Panics

This function does not panic.

pub async fn remove(&self, id: &str) -> bool

Remove the scheduled prompt with the given id.

Returns true if a prompt with that ID existed and was removed, false if no matching ID was found.

Panics

This function does not panic.

pub async fn list(&self) -> Vec<ScheduledPrompt>

Return a snapshot of all registered prompts (including disabled ones).

Panics

This function does not panic.

pub async fn set_enabled(&self, id: &str, enabled: bool) -> bool

Enable or disable a scheduled prompt by ID.

Returns true when the prompt was found and updated.

Panics

This function does not panic.

pub fn spawn(self: &Arc<Self>) -> JoinHandle<()>

Spawn the background scheduler task and return its [JoinHandle].

The task loops forever, sleeping until the next minute boundary, then submitting all matching prompts. It stops when the handle is dropped or [JoinHandle::abort] is called.

Panics

The spawned task does not panic; any submission errors are logged and skipped.