498c6f17a6
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.
94 lines
3.1 KiB
Go
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
|
|
}
|