Notifications

Redstick Agents provides real-time notifications for execution events, team activity, and action items.

Notification Delivery#

Notifications are delivered through two channels:

  1. Real-time WebSocket — Instant push to the browser
  2. Email digests — Periodic email summaries of unread notifications

Notification Types#

Execution Events#

  • Task started — An agent execution has begun
  • Task completed — An agent finished its task
  • Task failed — An agent encountered an error
  • Task timed out — An execution exceeded its time limit
  • Task needs approval — An execution needs your approval before continuing

Session Events#

  • Session started — A planning or workflow session has begun
  • Session paused — A session is waiting for input
  • Session resumed — A paused session has restarted
  • Session crashed — A session encountered a fatal error
  • Session idle timeout — A session was stopped due to inactivity

Notification Center#

Access the notification center from the sidebar:

  • Unread count badge shows pending notifications
  • Action required summary highlights items needing your attention
  • Thread view — Related notifications are grouped into threads
  • Mark as read — Mark individual or bulk notifications as read
  • Dismiss — Remove notifications you've handled

Preferences#

Customize notification behavior from Notification Preferences:

  • Enable/disable notifications per channel
  • Control which event types trigger notifications
  • Configure email digest frequency

Email Digests#

The platform sends periodic email digests summarizing unread notifications. The digest sender runs as a background task and batches notifications to avoid excessive emails.

Retention#

Old notifications are automatically pruned by the retention pruner background task. This keeps the notification list manageable and the database clean.