Notifications and weekly digest

Hands-free needs to be observable. The agent never makes a change you cannot see. Three notification surfaces keep you informed.

In-app notifications

Every campaign-level event the agent triggers inserts a row in the agent_notifications table. The dashboard notifications panel (bell icon in the top nav) renders them in reverse-chronological order. Click any notification to jump to the session in the Optimize tab.

Notifications carry:

  • Title (short summary: "Agent applied 3 changes to your HVAC campaign")
  • Body (detail with action labels + rollback window)
  • Optimization session ID (clickable deep-link to the session)
  • Campaign ID (clickable to the campaign detail page)
  • Explainability class (informational, strategic, etc.)
  • Read state (mark as read with one click)

When notifications fire

  • Hands-free auto-execution. One per session summarizing what changed.
  • Auto-rollback. One per rollback explaining what was reverted, why (which window failed), and what metrics moved.
  • Circuit breaker trip. One when a user-level breaker disables hands-free (3+ rollbacks in 30d).
  • Broken URL detected. When check-url-health flips a landing page to broken state.
  • Conversion tracking broken. When the agent detects 50+ clicks with zero conversions + zero CRM leads.

Notifications never fire for changes you made yourself (clicking Approve on a recommendation). The action was visible in the UI when you clicked, so double-notifying is noise.

Weekly digest email (Max)

Every Sunday at 13:00 UTC, Max users get an email summarizing the past 7 days:

  • Improved sessions: changes whose T+7d/T+14d verdict was "improved."
  • Rolled-back sessions: changes whose verdict was "worsened" and were auto-reverted.
  • Pending decisions: large or legally-dicey recommendations waiting for your approval.
  • KPI rollup: spend, conversions, CPA with week-over-week delta pills.

Skipped for empty-week users. Dedupe: 6-day minimum gap so a manual trigger does not double-send.

Every improved session in the weekly digest carries an "Undo this change" link signed with HMAC-SHA256 (7-day expiry, constant-time verification). One click reverts the change without needing to log into the dashboard. Useful when you spot something on mobile and want to act before opening your laptop.

Next steps
Auto-rollback→
Mechanics behind the rollback link
Hands-free mode→
When the agent acts at all