Files
pipelines/internal/protocol/notification_settings.go
T
alan 498c6f17a6 Add server notification settings with app checkboxes
Persist three global ntfy switches in server_settings: run_finished
(default on: auto-mode runs notify on success, read inside the
transition transaction; on/off modes unchanged), chat_needs_you
(default on: gates chat question/approval alerts) and
chat_reply_finished (default off: one alert per finished assistant
turn). Expose notification_settings / set_notification_settings over
the websocket protocol, add a Phone notifications section with
Material and Cupertino checkboxes in Settings, document the settings,
and keep the cli, tui, stage and pipeline test packages from
inheriting a real ntfy configuration.
2026-10-30 21:36:27 +00:00

94 lines
3.1 KiB
Go

package protocol
import (
"fmt"
"sort"
)
// Notification settings are the operator's global choices about which events
// publish through the server's ntfy connection. A client reads them with
// {"type":"notification_settings"} and changes them with
// {"type":"set_notification_settings","notification_settings":{"<key>":bool}};
// a set may name any subset of keys, and unknown keys or non-boolean values
// are refused. Both replies have type "notification_settings" and carry every
// key with its stored value.
const (
GetNotificationSettings = "notification_settings"
SetNotificationSettings = "set_notification_settings"
NotificationSettingsReply = "notification_settings"
)
// Notification setting keys, as carried on the wire.
const (
NotifyRunFinished = "run_finished"
NotifyChatNeedsYou = "chat_needs_you"
NotifyChatReplyFinished = "chat_reply_finished"
)
// NotificationSettings is the typed form of the global notification choices.
type NotificationSettings struct {
// RunFinished notifies when a run with notify mode "auto" succeeds. Runs
// started with notifications "on" always notify and "off" never do.
RunFinished bool
// ChatNeedsYou notifies when a chat asks a question or requests approval.
ChatNeedsYou bool
// ChatReplyFinished notifies when an assistant turn in a chat ends.
ChatReplyFinished bool
}
// NotificationSettingKeys lists every setting key in a stable order.
var NotificationSettingKeys = []string{NotifyRunFinished, NotifyChatNeedsYou, NotifyChatReplyFinished}
// DefaultNotificationSettings are the values before the operator changes any.
func DefaultNotificationSettings() NotificationSettings {
return NotificationSettings{RunFinished: true, ChatNeedsYou: true, ChatReplyFinished: false}
}
// Map returns the wire form with every key present.
func (s NotificationSettings) Map() map[string]any {
return map[string]any{
NotifyRunFinished: s.RunFinished,
NotifyChatNeedsYou: s.ChatNeedsYou,
NotifyChatReplyFinished: s.ChatReplyFinished,
}
}
// Field returns a pointer to the setting named key, or nil for an unknown key.
func (s *NotificationSettings) Field(key string) *bool {
switch key {
case NotifyRunFinished:
return &s.RunFinished
case NotifyChatNeedsYou:
return &s.ChatNeedsYou
case NotifyChatReplyFinished:
return &s.ChatReplyFinished
}
return nil
}
// ValidateNotificationSettingsUpdate checks a partial update: at least one key,
// every key known and every value a boolean.
func ValidateNotificationSettingsUpdate(update map[string]any) (map[string]bool, error) {
if len(update) == 0 {
return nil, fmt.Errorf("notification_settings must name at least one setting")
}
keys := make([]string, 0, len(update))
for key := range update {
keys = append(keys, key)
}
sort.Strings(keys)
result := make(map[string]bool, len(update))
var probe NotificationSettings
for _, key := range keys {
if probe.Field(key) == nil {
return nil, fmt.Errorf("unknown notification setting %q", key)
}
value, ok := update[key].(bool)
if !ok {
return nil, fmt.Errorf("notification setting %q must be true or false", key)
}
result[key] = value
}
return result, nil
}