schedule

Manage scheduled automations. Schedules can be **recurring** (cron or RRULE expression) or **one-shot** (a single `fire_at` timestamp). Schedules support four modes: **execute** (run a message through the assistant), **notify** (send a notification to the user), **script** (run a shell command directly without LLM involvement), and **workflow** (run a saved multi-agent workflow by name). ## Schedule Syntax ### Cron Standard 5-field cron syntax: `minute hour day-of-month month day-of-week` | Field | Values | Special characters | | ------------ | ------------- | ------------------ | | Minute | 0-59 | , - \* / | | Hour | 0-23 | , - \* / | | Day of month | 1-31 | , - \* / | | Month | 1-12 | , - \* / | | Day of week | 0-7 (0,7=Sun) | , - \* / | Examples: - `0 9 * * 1-5` - weekdays at 9:00 AM - `30 8 * * *` - every day at 8:30 AM - `0 */2 * * *` - every 2 hours - `0 9 1 * *` - first of every month at 9:00 AM ### RRULE (RFC 5545) iCalendar recurrence rules for complex patterns. Must include a DTSTART line. Supported lines (all expressions must include DTSTART + at least one RRULE or RDATE): | Line | Purpose | | --------- | ------------------------------------------------------- | | `DTSTART` | Start date/time anchor (required) | | `RRULE:` | Recurrence rule (multiple lines = uni...