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":{"":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 }