Notifications

Runeya automatically notifies you of important events via in-app notifications. You can enable or disable each notification type according to your preferences.

Notification Types

Notifications are grouped by theme:

Scenarios

Notification	Description
scenario_waiting_input	A Scenario is paused and waiting for your input on an ask_user node.

AI Conversations

Notification	Description
ai_conversation_complete	An AI conversation (or a Scenario run) completed successfully.
ai_conversation_error	An AI conversation or Scenario encountered an error.

Services

Notification	Description
service_error_log	A service produced an error-level log line.
service_status_changed	A service's status changed (started, stopped, restarted…).
service_health_changed	A service's health check result changed (healthy, unhealthy).

Default Behavior

All notifications are enabled by default on the first Runeya launch. Your preferences are saved in .runeya/settings.json.

Enabling or Disabling Notifications

From the Interface

1. Go to Settings → Notifications.
2. Notifications are grouped into three sections: Scenarios, AI Conversations, and Services.
3. For each notification, use the toggle to enable or disable it.

Quick Controls per Section

Each section has two shortcuts:

• Enable all: enables all notifications in the section in one click.
• Disable all: disables all notifications in the section in one click.

You can also collapse or expand each section by clicking its header (chevron).

From settings.json

You can also edit preferences directly in the configuration file:

{
  "notifications": {
    "scenario_waiting_input": true,
    "ai_conversation_complete": true,
    "ai_conversation_error": true,
    "service_error_log": false,
    "service_status_changed": true,
    "service_health_changed": true
  }
}

Change the value of each key (true to enable, false to disable), then restart Runeya for the changes to take effect.

FAQ

Are notifications sent by email or SMS? No. Runeya notifications are displayed in the web interface only. There is no email, SMS, or webhook delivery at this time.

Can I be notified when a service starts? Yes. Enable service_status_changed — you will be notified on every service status change, including startup.

Is the scenario_waiting_input notification important? Yes. If you disable this notification, you may not notice that a Scenario is waiting for your response, which could block its execution indefinitely.