> ## Documentation Index
> Fetch the complete documentation index at: https://openclaw.veiseule.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Menyrad

# Statuslogik för menyraden

## Vad som visas

* Vi visar den aktuella agentens arbetsstatus i menyradsikonen och i den första statusraden i menyn.
* Hälsostatus döljs medan arbete är aktivt; den återkommer när alla sessioner är inaktiva.
* Blocket ”Nodes” i menyn listar endast **enheter** (parade noder via `node.list`), inte klient-/närvaroposter.
* Ett avsnitt ”Usage” visas under Context när ögonblicksbilder av leverantörsanvändning finns tillgängliga.

## Tillståndsmodell

* Sessioner: händelser anländer med `runId` (per-run) plus `sessionKey` i nyttolasten. “main” sessionen är nyckeln `main`; om den saknas, vi faller tillbaka till den senast uppdaterade sessionen.
* Prioritet: main alltid vinner. Om huvud är aktiv, dess tillstånd visas omedelbart. Om huvud är inaktiv, den senaste aktiva non‐main sessionen visas. Vi växlar inte flip‐flop mid‐activity; vi växlar bara när den aktuella sessionen går vilande eller main blir aktiv.
* Aktivitetstyper:
  * `job`: exekvering av kommandon på hög nivå (`state: started|streaming|done|error`).
  * `tool`: `phase: start|result` med `toolName` och `meta/args`.

## IconState-enum (Swift)

* `idle`
* `workingMain(ActivityKind)`
* `workingOther(ActivityKind)`
* `overridden(ActivityKind)` (felsökningsåsidosättning)

### ActivityKind → glyf

* `exec` → 💻
* `read` → 📄
* `write` → ✍️
* `edit` → 📝
* `attach` → 📎
* default → 🛠️

### Visuell mappning

* `idle`: vanlig varelse.
* `workingMain`: märke med glyph, full toning, ”working”-benanimation.
* `workingOther`: märke med glyph, dämpad toning, ingen scurry.
* `overridden`: använder vald glyph/toning oavsett aktivitet.

## Statusradstext (meny)

* När arbete är aktivt: `<Session role> · <activity label>`
  * Exempel: `Main · exec: pnpm test`, `Other · read: apps/macos/Sources/OpenClaw/AppState.swift`.
* När inaktiv: faller tillbaka till hälsosammanfattningen.

## Händelseintag

* Källa: control‑channel `agent`‑händelser (`ControlChannel.handleAgentEvent`).
* Parsade fält:
  * `stream: "job"` med `data.state` för start/stopp.
  * `stream: "tool"` med `data.phase`, `name`, valfritt `meta`/`args`.
* Etiketter:
  * `exec`: första raden av `args.command`.
  * `read`/`write`: förkortad sökväg.
  * `edit`: sökväg plus härledd ändringstyp från `meta`/diff‑antal.
  * reserv: verktygsnamn.

## Felsökningsåsidosättning

* Inställningar ▸ Debug ▸ väljare för ”Icon override”:
  * `System (auto)` (standard)
  * `Working: main` (per verktygstyp)
  * `Working: other` (per verktygstyp)
  * `Idle`
* Lagring via `@AppStorage("iconOverride")`; mappas till `IconState.overridden`.

## Testchecklista

* Starta jobb i huvudsessionen: verifiera att ikonen växlar omedelbart och att statusraden visar huvudetiketten.
* Starta jobb i icke‑huvudsession medan huvudsessionen är inaktiv: ikon/status visar icke‑huvudsessionen; förblir stabil tills den är klar.
* Starta huvudsessionen medan annan är aktiv: ikonen växlar till huvudsessionen direkt.
* Snabba verktygsburstar: säkerställ att märket inte flimrar (TTL‑marginal på verktygsresultat).
* Hälsoraden visas igen när alla sessioner är inaktiva.