cost

Documentation

Overview

Package cost implements per-service cost alerting for nSelf AI and media plugins. It runs hourly (via the cron plugin or nself doctor), queries np_ai_usage.cost_usd for the last 24h, and fires a Slack webhook when any configured budget is exceeded.

Configuration env vars:

COST_ALERT_ENABLED       true | false (default false)
COST_BUDGET_AI_DAILY_USD float, e.g. "5.00"
COST_BUDGET_MEDIA_DAILY_USD float
COST_BUDGET_TOTAL_DAILY_USD float
SLACK_WEBHOOK_URL        https://hooks.slack.com/...
SLACK_ALERT_CHANNEL      #nself-alerts (informational only — embedded in message)

Index

• func Enabled() bool
• type Alerter
  • func New(db *sql.DB, budget Budget) *Alerter
  • func (a *Alerter) CheckAndAlert(ctx context.Context) error
• type Budget
  • func LoadBudgetFromEnv() Budget

Functions

func Enabled

func Enabled() bool

Enabled returns true when COST_ALERT_ENABLED=true.

Types

type Alerter

type Alerter struct {
	DB         *sql.DB
	Budget     Budget
	HTTPClient *http.Client
	Log        *slog.Logger
}

Alerter checks cost against budgets and sends Slack notifications on breach.

func New

func New(db *sql.DB, budget Budget) *Alerter

New creates an Alerter with defaults.

func (*Alerter) CheckAndAlert

func (a *Alerter) CheckAndAlert(ctx context.Context) error

CheckAndAlert queries the last 24h of cost_usd from np_ai_usage, compares against configured budgets, and posts to Slack on breach. It is safe to call from a cron handler or periodic health check.

type Budget

type Budget struct {
	AIDailyUSD    float64
	MediaDailyUSD float64
	TotalDailyUSD float64
}

Budget holds per-service daily spend limits in USD. A zero value means "no limit for this service".

func LoadBudgetFromEnv

func LoadBudgetFromEnv() Budget

LoadBudgetFromEnv reads COST_BUDGET_* vars and returns the parsed Budget. Malformed values are ignored (budget treated as unlimited).