Logika stanu paska menu¶

Co jest wyświetlane¶

• Prezentujemy bieżący stan pracy agenta w ikonie paska menu oraz w pierwszym wierszu stanu menu.
• Stan zdrowia jest ukryty podczas aktywnej pracy; wraca, gdy wszystkie sesje są bezczynne.
• Blok „Nodes” w menu wyświetla wyłącznie urządzenia (sparowane węzły przez node.list), a nie wpisy klienta/obecności.
• Sekcja „Usage” pojawia się pod Kontekstem, gdy dostępne są migawki użycia dostawcy.

Model stanu¶

• Sesje: zdarzenia przychodzą z runId (na uruchomienie) wraz z sessionKey w ładunku. „Główna” sesja ma klucz main; jeśli go brakuje, wracamy do ostatnio zaktualizowanej sesji.
• Priorytet: główna zawsze wygrywa. Jeśli główna jest aktywna, jej stan jest wyświetlany natychmiast. Jeśli główna jest bezczynna, wyświetlana jest ostatnio aktywna sesja niegłówna. Nie przełączamy się w trakcie aktywności; zmiana następuje tylko wtedy, gdy bieżąca sesja przechodzi w bezczynność lub gdy główna staje się aktywna.
• Rodzaje aktywności:
• job: wysokopoziomowe wykonywanie poleceń (state: started|streaming|done|error).
• tool: phase: start|result z toolName oraz meta/args.

Enum IconState (Swift)¶

• idle
• workingMain(ActivityKind)
• workingOther(ActivityKind)
• overridden(ActivityKind) (nadpisanie debugowe)

ActivityKind → glif¶

• exec → 💻
• read → 📄
• write → ✍️
• edit → 📝
• attach → 📎
• domyślnie → 🛠️

Mapowanie wizualne¶

• idle: normalny stworek.
• workingMain: odznaka z glifem, pełne zabarwienie, animacja „pracy” nóg.
• workingOther: odznaka z glifem, stonowane zabarwienie, brak „biegania”.
• overridden: używa wybranego glifu/zabarwienia niezależnie od aktywności.

Tekst wiersza stanu (menu)¶

• Gdy praca jest aktywna: <Session role> · <activity label>
• Przykłady: Main · exec: pnpm test, Other · read: apps/macos/Sources/OpenClaw/AppState.swift.
• Gdy bezczynne: powrót do podsumowania stanu zdrowia.

Ingest zdarzeń¶

• Źródło: zdarzenia agent kanału kontrolnego (ControlChannel.handleAgentEvent).
• Parsowane pola:
• stream: "job" z data.state dla start/stop.
• stream: "tool" z data.phase, name, opcjonalnie meta/args.
• Etykiety:
• exec: pierwsza linia args.command.
• read/write: skrócona ścieżka.
• edit: ścieżka plus wnioskowany rodzaj zmiany z meta/liczników diff.
• rezerwowo: nazwa narzędzia.

Nadpisanie debugowe¶

• Ustawienia ▸ Debug ▸ selektor „Icon override”:
• System (auto) (domyślne)
• Working: main (wg rodzaju narzędzia)
• Working: other (wg rodzaju narzędzia)
• Idle
• Przechowywane przez @AppStorage("iconOverride"); mapowane do IconState.overridden.

Lista kontrolna testów¶

• Uruchom zadanie głównej sesji: sprawdź, czy ikona przełącza się natychmiast i wiersz stanu pokazuje etykietę główną.
• Uruchom zadanie sesji niegłównej, gdy główna jest bezczynna: ikona/stan pokazują niegłówną; pozostaje stabilne do zakończenia.
• Uruchom główną, gdy inna jest aktywna: ikona przełącza się na główną natychmiast.
• Szybkie serie narzędzi: upewnij się, że odznaka nie migocze (okres łaski TTL dla wyników narzędzi).
• Wiersz zdrowia pojawia się ponownie, gdy wszystkie sesje są bezczynne.