notification

type Content struct {
	Title    string
	Body     string
	Subtitle string
	Category string // info, attention, progress; never an analyzer status
}

type Deadline struct {
	BootID   string
	NotAfter float64
}

type DeliveryPort interface {
	Deliver(context.Context, Request) Receipt
}

type DesktopTarget struct {
	Provider        string
	Linux           LinuxBinding
	ThreadID        string
	ApplicationPath string
	TeamID          string
}

type LinuxBinding struct {
	SnapshotPath string `json:"snapshotPath"`
	SHA256       string `json:"sha256"`
}

type Navigation string

type NavigationResult struct {
	Capability string // available, unavailable, disabled
	Precision  string // chat_id or none
	Scope      string
	Reason     string
}

type PolicySnapshot struct {
	Valid           bool
	ExplicitEnabled bool
	DesktopEnabled  bool
	ClickToFocus    bool
	SoundEnabled    bool
}

type Readiness struct {
	CorrelationID string
	Status        string // ready, rejected, suppressed
	Reason        string
	Backend       string
	Navigation    NavigationResult
}

type ReadinessPort interface {
	CheckReadiness(context.Context, Request) Readiness
}

type Receipt struct {
	CorrelationID string
	Status        string // rejected, suppressed, submitted, unknown
	Reason        string
	RetrySafe     bool // always false here: delivery does not own replay admission
	Backend       string
	Navigation    NavigationResult
}

type Request struct {
	Content       Content
	CorrelationID string // UUID assigned by the durable admission owner
	Deadline      Deadline
	Policy        PolicySnapshot
	Navigation    Navigation // empty defaults to Required
	Target        DesktopTarget
	Silent        bool
}