Struct ReminderManager 

pub struct ReminderManager { /* private fields */ }

Implementations

impl ReminderManager

pub fn new(store: Arc<dyn ReminderStore>) -> Self

pub fn create(&self, input: CreateReminder) -> Result<Reminder, ReminderError>

Create and persist a new reminder. Returns the fully-populated record.

pub fn get(&self, id: &str) -> Result<Reminder, ReminderError>

Retrieve a reminder by ID.

pub fn list( &self, filter: &ReminderFilter, ) -> Result<Vec<Reminder>, ReminderError>

Return all reminders matching filter.

pub fn remind_me(&self) -> Result<Vec<Reminder>, ReminderError>

Return all reminders that are currently actionable: status Due or AwaitingPermission, ordered by priority then due_at.

Also promotes Pending reminders whose due_at <= now to Due (lazy promotion — avoids the need for a background timer).

pub fn snooze( &self, id: &str, until: DateTime<Utc>, ) -> Result<Reminder, ReminderError>

Snooze a reminder until until. Valid from Due, AwaitingPermission, or InProgress states.

pub fn cancel(&self, id: &str) -> Result<Reminder, ReminderError>

Cancel a reminder. Idempotent if already cancelled.

pub fn approve( &self, id: &str, approved_by: &str, ) -> Result<Reminder, ReminderError>

Approve a non-autonomous reminder for execution, recording who approved. Transitions AwaitingPermission → Due.

pub fn start(&self, id: &str, agent_id: &str) -> Result<Reminder, ReminderError>

Mark a reminder as in-progress. Transitions Due → InProgress. Non-autonomous reminders must be approved first.

pub fn record_execution( &self, id: &str, record: ExecutionRecord, ) -> Result<Reminder, ReminderError>

Complete an execution attempt, appending the ExecutionRecord.

On Success:

• If the reminder has a repeating schedule, compute next_due and reset to Pending.
• Otherwise mark Completed.

On non-autonomous reminders that have not yet been approved, this method transitions to AwaitingPermission instead of Due after schedule advancement.

pub fn mark_ref_stale( &self, id: &str, ref_id: &str, ) -> Result<usize, ReminderError>

Mark a ref as stale by ref_id. Returns the number of refs updated.