notify

type Config struct {
	Version   int              `json:"version"`
	Providers []ProviderConfig `json:"providers"`
}

type Coordinator struct {
	// contains filtered or unexported fields
}

type Counts struct {
	Waiting int `json:"waiting"`
	Idle    int `json:"idle"`
	Running int `json:"running"`
}

type Event struct {
	Title    string            `json:"title"`
	Kind     Kind              `json:"kind"`
	Counts   Counts            `json:"counts"`
	Sessions []SessionRef      `json:"sessions"` // recency-sorted; ALL live (renderer caps for display)
	Summary  string            `json:"summary"`  // optional pre-rolled stat blocks (delta/today), host-built
	DeepURL  string            `json:"deepUrl"`  // tap target; may be empty
	Extra    map[string]string `json:"extra"`    // free fields for non-session hosts (pro: platform/count)
}

type EventRecord struct {
	At      time.Time `json:"at"`
	Kind    Kind      `json:"kind"`
	Results []Result  `json:"results"`
}

type Kind int

type Metrics struct {
	// contains filtered or unexported fields
}

type MetricsState struct {
	Events      int                     `json:"events"`
	LastMs      int64                   `json:"lastMs"`
	TodayDay    int                     `json:"todayDay"`
	Sent        map[string]int          `json:"sent"`
	Dormant     map[string]int          `json:"dormant"`
	Failed      map[string]int          `json:"failed"`
	Today       map[string]int          `json:"today"`
	LastSuccess map[string]int64        `json:"lastSuccess"` // provider → unix ms
	Recent      map[string][]RecentSend `json:"recent"`
}

type MetricsView struct {
	Events      int              `json:"events"`
	LastAtMs    int64            `json:"lastAtMs"` // 0 = never
	PerProvider []ProviderMetric `json:"perProvider"`
}

type Outcome int

type Provider interface {
	Kind() string // stable id: "ilink" | "webpush" | "feishu" | "dingtalk" | "wecom"
	Name() string // display: "微信" | "浏览器" | "飞书" | "钉钉" | "企业微信"
	// Send renders e to the channel's native format and delivers it. cfg is this
	// provider's current config (Settings carries webhook url/secret etc.). It returns
	// the Outcome plus a short human-readable detail for troubleshooting — the failure
	// reason on failure (e.g. "订阅失效(410 Gone)", "BadJwtToken", "休眠:配额满"), "" on
	// clean success. The detail flows into the recent-3 history shown in the UI.
	Send(ctx context.Context, e Event, cfg ProviderConfig) (Outcome, string)
	// Status reports runtime health. The provider does NOT set Status.Enabled
	// (Coordinator joins it from Config) nor TodaySent (Coordinator joins metrics).
	Status(ctx context.Context, cfg ProviderConfig) Status
}

type ProviderConfig struct {
	Kind     string          `json:"kind"`
	Enabled  bool            `json:"enabled"`
	Settings json.RawMessage `json:"settings,omitempty"` // per-kind (webhook: {url,secret})
}

type ProviderMetric struct {
	Provider        string       `json:"provider"`
	Sent            int          `json:"sent"`
	Dormant         int          `json:"dormant"`
	Failed          int          `json:"failed"`
	LastSuccessAtMs int64        `json:"lastSuccessAtMs"` // 0 = never succeeded
	Recent          []RecentSend `json:"recent"`          // last recentCap attempts (newest last)
}

type Quota struct {
	Used int `json:"used"`
	Max  int `json:"max"`
}

type RecentSend struct {
	AtMs    int64   `json:"atMs"`
	Outcome Outcome `json:"outcome"`
	Detail  string  `json:"detail,omitempty"` // failure reason ("订阅失效(410)", "BadJwtToken"…)
}

type Result struct {
	Provider string  `json:"provider"`
	Outcome  Outcome `json:"outcome"`
	Detail   string  `json:"detail,omitempty"` // optional ("429", "BadJwtToken", "dormant: quota")
}

type SessionRef struct {
	Tool        string `json:"tool"`        // "claude" | "codex"
	Location    string `json:"location"`    // readable "where": "main · 窗口3 TERMINAL · 面板1"
	Status      string `json:"status"`      // "waiting" | "idle" | "running"
	JustChanged bool   `json:"justChanged"` // transitioned in this batch → 🆕 marker
	Turns       int    `json:"turns"`
	Stats       string `json:"stats"` // optional compact stats ("in 29k out 532k cc 2.3M cr 152.9M ~$112")
}

type Status struct {
	Kind           string `json:"kind"`
	Name           string `json:"name"`
	Enabled        bool   `json:"enabled"`    // filled by Coordinator from Config, not by the provider
	Configured     bool   `json:"configured"` // has creds / logged in / webhook set
	Healthy        bool   `json:"healthy"`
	Quota          *Quota `json:"quota,omitempty"` // nil for channels without a quota
	TodaySent      int    `json:"todaySent"`       // filled by Coordinator from metrics, not the provider
	ActivationHint string `json:"activationHint"`  // e.g. "回任意字符续订" / "未配置 webhook"（no creds）
}

type Store interface {
	Load(ctx context.Context) (Config, error)
	Save(ctx context.Context, c Config) error
}

type WebhookSettings struct {
	URL    string `json:"url"`
	Secret string `json:"secret,omitempty"` // optional signing secret (Feishu/DingTalk 加签)
}