Skip to content

Agent Notifications — Alerts, Permission Prompts & Toast Messages #421

@kovtcharov

Description

@kovtcharov

T7: Agent Notifications — Alerts, Permission Prompts & Toast Messages

Priority: p0

Notification system allowing agents to push alerts, permission requests, and status updates via JSON-RPC notification/send and notification/response methods (see MCP milestone: "GAIA MCP Protocol Extensions").

New Files

cpp/dotnet/GaiaTray/
├── Services/
│   ├── NotificationRouter.cs
│   ├── NotificationQueue.cs
│   └── NotificationHistory.cs
├── Forms/
│   ├── NotificationCenterForm.cs
│   └── PermissionPromptForm.cs
├── Controls/
│   └── ToastPanel.cs

Notification Types

Type Priority Display
permission_request Critical Modal dialog (blocks agent action)
security_alert High Toast + balloon + sound
status_change Medium Toast notification
info Low Notification center only
error High Toast + balloon

Permission Prompt UI

┌────────────────────────────────────────────┐
│  ⚠ Permission Required                     │
├────────────────────────────────────────────┤
│  Process Intelligence wants to:            │
│  🟡 kill_process                           │
│  Target: chrome.exe (PID 7234)             │
│  Reason: "Process consuming 89% CPU"       │
│                                            │
│  ☐ Remember this choice for this session   │
│  ☐ Always allow this tool (promote to 🟢) │
│       [Allow]    [Deny]    [View Details]  │
└────────────────────────────────────────────┘

Shows 🛡️ admin shield icon when x-requires-admin: true (triggers UAC after approval).

Features

  • Windows toast notifications via Microsoft.Toolkit.Uwp.Notifications
  • Balloon tips fallback via NotifyIcon.ShowBalloonTip()
  • Permission prompts: Modal dialogs with configurable timeout + default action
  • Notification center: Scrollable list with filter/search
  • Do Not Disturb mode
  • Sound alerts per notification type
  • Notification history: SQLite, last 30 days

Blocked by: #415 (T1)

See full spec

Metadata

Metadata

Assignees

No one assigned

    Labels

    domain:automationScheduler, autonomy, RAG, web search, watchers, researchdotnet.NET/C# implementationguiGUI / desktop applicationos-agentsOS agent MCP serversp0high prioritytrack:consumer-appHermes-competitor consumer product — mobile-first, voice + messaging + memory + skillstraySystem tray application

    Type

    No type

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions