Menubalk

# Wat wordt getoond

• We tonen de huidige werkstatus van de agent in het menubalkpictogram en in de eerste statusrij van het menu.
• De gezondheidsstatus wordt verborgen terwijl er werk actief is; deze keert terug wanneer alle sessies inactief zijn.
• Een hoofdsubmenu "Context" bevat recente sessies in plaats van ze rechtstreeks in het hoofdmenu uit te vouwen.
• Het blok "Knooppunten" in het hoofdmenu toont alleen apparaten (gekoppelde knooppunten via node.list), geen client-/aanwezigheidsitems.
• Een hoofdsectie "Gebruik" verschijnt onder Context wanneer snapshots van providergebruik beschikbaar zijn, gevolgd door gebruikskosten-details wanneer beschikbaar.

# Statusmodel

• Sessies: gebeurtenissen komen binnen met runId (per uitvoering) plus sessionKey in de payload. De "hoofd"-sessie is de sleutel main; als die ontbreekt, vallen we terug op de laatst bijgewerkte sessie.
• Prioriteit: hoofd wint altijd. Als hoofd actief is, wordt de status ervan onmiddellijk getoond. Als hoofd inactief is, wordt de meest recent actieve niet-hoofdsessie getoond. We wisselen niet heen en weer tijdens activiteit; we schakelen alleen wanneer de huidige sessie inactief wordt of hoofd actief wordt.
• Activiteitstypen:
  • job: opdrachtuitvoering op hoog niveau (state: started|streaming|done|error).
  • tool: phase: start|result met toolName en meta/args.

# IconState-enum (Swift)

• idle
• workingMain(ActivityKind)
• workingOther(ActivityKind)
• overridden(ActivityKind) (debug-override)

# ActivityKind → symbool

• exec → 💻
• read → 📄
• write → ✍️
• edit → 📝
• attach → 📎
• standaard → 🛠️

# Visuele mapping

• idle: normaal beestje.
• workingMain: badge met symbool, volledige tint, "werkende" beenanimatie.
• workingOther: badge met symbool, gedempte tint, geen gehaast.
• overridden: gebruikt het gekozen symbool/de gekozen tint ongeacht de activiteit.

# Contextsubmenu

• Het hoofdmenu toont één rij "Context" met een sessietelling/-status en opent een submenu.
• De koptekst van het Contextsubmenu toont het aantal actieve sessies van de laatste 24 uur.
• Elke sessierij behoudt de tokenbalk, leeftijd, preview, denk-/verbose-status, en acties voor resetten, compact maken en verwijderen.
• Berichten voor laden, verbroken verbinding en fouten bij het laden van sessies verschijnen binnen het Contextsubmenu.
• Providergebruik en gebruikskosten-details blijven op hoofdniveau onder Context, zodat ze in één oogopslag zichtbaar blijven zonder het submenu te openen.

# Statusrijtekst (menu)

• Terwijl werk actief is: &lt;Session role&gt; · <activity label>
  • Voorbeelden: Main · exec: pnpm test, Other · read: apps/macos/Sources/OpenClaw/AppState.swift.
• Wanneer inactief: valt terug op de gezondheidssamenvatting.

# Gebeurtenisinname

• Bron: control-channel agent-gebeurtenissen (ControlChannel.handleAgentEvent).
• Geparste velden:
  • stream: "job" met data.state voor starten/stoppen.
  • stream: "tool" met data.phase, name, optioneel meta/args.
• Labels:
  • exec: eerste regel van args.command.
  • read/write: verkort pad.
  • edit: pad plus afgeleide wijzigingssoort uit meta/diff-tellingen.
  • fallback: toolnaam.

# Debug-override

• Instellingen ▸ Debug ▸ keuzelijst "Pictogram-override":
  • System (auto) (standaard)
  • Working: main (per toolsoort)
  • Working: other (per toolsoort)
  • Idle
• Opgeslagen via @AppStorage("iconOverride"); gemapt naar IconState.overridden.

# Testchecklist

• Activeer taak in hoofdsessie: controleer of het pictogram onmiddellijk wisselt en de statusrij het hoofdlabel toont.
• Activeer taak in niet-hoofdsessie terwijl hoofd inactief is: pictogram/status toont niet-hoofd; blijft stabiel totdat deze is voltooid.
• Start hoofd terwijl andere sessie actief is: pictogram schakelt direct naar hoofd.
• Snelle toolbursts: zorg dat de badge niet flikkert (TTL-gratie op toolresultaten).
• Gezondheidsrij verschijnt opnieuw zodra alle sessies inactief zijn.

# Gerelateerd

• macOS-app
• Menubalkpictogram