Menyu paneli holati logikasi¶

Nimalar ko‘rsatiladi¶

• Joriy agent ish holatini menyu paneli ikonkasida va menyuning birinchi holat qatorida ko‘rsatamiz.
• Ish faol bo‘lganda sog‘liq holati yashiriladi; barcha sessiyalar bo‘sh turganda u qaytadi.
• Menyudagi “Nodes” bloki faqat qurilmalarni ( node.list orqali juftlangan tugunlar) ko‘rsatadi, klient/presence yozuvlarini emas.
• Provider foydalanish snapshotlari mavjud bo‘lganda Context ostida “Usage” bo‘limi paydo bo‘ladi.

Holat modeli¶

• Sessiyalar: hodisalar payload ichida runId (har bir ishga tushirish uchun) va sessionKey bilan keladi. “Asosiy” sessiya kaliti main; agar u bo‘lmasa, eng yaqinda yangilangan sessiyaga qaytamiz.
• Ustuvorlik: main har doim yutadi. Agar main faol bo‘lsa, uning holati darhol ko‘rsatiladi. Agar main bo‘sh turgan bo‘lsa, eng yaqinda faol bo‘lgan main bo‘lmagan sessiya ko‘rsatiladi. Faoliyat o‘rtasida almashib ketmaymiz; faqat joriy sessiya bo‘sh holatga o‘tganda yoki main faol bo‘lganda almashtiramiz.
• Faoliyat turlari:
• job: yuqori darajadagi buyruq bajarilishi (state: started|streaming|done|error).
• tool: phase: start|result bilan toolName va meta/args.

IconState enumeratsiyasi (Swift)¶

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

ActivityKind → glif¶

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

Vizual moslashtirish¶

• idle: oddiy jonzot.
• workingMain: glifli belgi, to‘liq rang, oyoqlarning “working” animatsiyasi.
• workingOther: glifli belgi, xiralashtirilgan rang, yugurishsiz.
• overridden: faoliyatdan qat’i nazar tanlangan glif/rangdan foydalanadi.

Holat qatori matni (menyu)¶

• Ish faol bo‘lganda: <Session role> · <activity label>
• Misollar: Main · exec: pnpm test, Other · read: apps/macos/Sources/OpenClaw/AppState.swift.
• Bo‘sh turganda: sog‘liq xulosasiga qaytadi.

Hodisalarni qabul qilish¶

• Source: control‑channel agent events (ControlChannel.handleAgentEvent).
• Parsed fields:
• stream: "job" with data.state for start/stop.
• stream: "tool" with data.phase, name, optional meta/args.
• Labels:
• exec: first line of args.command.
• read/write: shortened path.
• edit: path plus inferred change kind from meta/diff counts.
• fallback: tool name.

Debug override¶

• Settings ▸ Debug ▸ “Icon override” picker:
• System (auto) (default)
• Working: main (per tool kind)
• Working: other (per tool kind)
• Idle
• Stored via @AppStorage("iconOverride"); mapped to IconState.overridden.

Testing checklist¶

• Trigger main session job: verify icon switches immediately and status row shows main label.
• Trigger non‑main session job while main idle: icon/status shows non‑main; stays stable until it finishes.
• Start main while other active: icon flips to main instantly.
• Rapid tool bursts: ensure badge does not flicker (TTL grace on tool results).
• Health row reappears once all sessions idle.