Struct NotificationPreferences 

pub struct NotificationPreferences {
    pub enabled: bool,
    pub on_clarification: bool,
    pub on_tool_approval: bool,
    pub on_context_pressure: bool,
    pub on_subagent_complete: bool,
}

Per-user notification opt-in flags.

enabled is the master switch; when false, no notifications are produced regardless of the per-category flags. Each per-category flag gates a single notification category.

Every field defaults to true (via serde(default = ...)), so missing keys in a partial JSON document are treated as opted-in.

Fields

enabled: bool

Master switch. When false, nothing is ever notified.

on_clarification: bool

Notify when the agent needs free-form clarification from the user.

on_tool_approval: bool

Notify when a tool requires explicit user approval.

on_context_pressure: bool

Notify when context usage reaches a critical level.

on_subagent_complete: bool

Notify when a background sub-agent task completes.

Implementations

impl NotificationPreferences

pub fn load(path: &Path) -> Self

Loads preferences from path.

Returns Default when the file is missing (a fresh install) so the caller never has to special-case first run. A file that exists but fails to parse is logged via tracing::warn and also falls back to Default, so a corrupt file never disables notifications silently.

pub fn save(&self, path: &Path) -> Result<()>

Persists preferences to path as pretty JSON.

Creates the parent directory if it does not yet exist.

Trait Implementations

impl Clone for NotificationPreferences

fn clone(&self) -> NotificationPreferences

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NotificationPreferences

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for NotificationPreferences

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NotificationPreferences

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for NotificationPreferences

fn eq(&self, other: &NotificationPreferences) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for NotificationPreferences

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for NotificationPreferences