​

메뉴 바 상태 로직

​

표시되는 항목

• 현재 에이전트 작업 상태는 메뉴 바 아이콘과 메뉴의 첫 번째 상태 행에 표시됩니다.
• 작업이 진행 중일 때는 상태를 숨기며, 모든 세션이 유휴 상태일 때 다시 나타납니다.
• 메뉴의 “노드” 블록은 디바이스만 나열합니다 (node.list를 통한 연결된 노드), 클라이언트/프레젠스 항목은 포함되지 않습니다.
• 공급자 사용 스냅샷이 사용 가능할 때 컨텍스트 아래 “사용량” 섹션이 나타납니다.

​

상태 모델

• 세션: 이벤트는 페이로드에 runId(실행별)와 sessionKey와 함께 도착합니다. “메인” 세션은 키 main입니다. 없을 경우, 가장 최근에 업데이트된 세션을 사용합니다.
• 우선순위: 항상 메인이 우선입니다. 메인이 활성 상태이면 그 상태가 즉시 표시됩니다. 메인이 유휴일 경우, 가장 최근에 활동했던 비 메인 세션이 표시됩니다. 활동 중간에 전환하지 않으며, 현재 세션이 유휴로 전환되거나 메인이 활성화될 때만 변경됩니다.
• 활동 종류:
  • job: 고수준 명령어 실행 (state: 시작됨|스트리밍|완료|오류).
  • tool: phase: 시작|결과와 함께 toolName과 meta/args.

​

IconState 열거형 (Swift)

• idle
• workingMain(ActivityKind)
• workingOther(ActivityKind)
• overridden(ActivityKind) (디버그 오버라이드)

​

ActivityKind → 글리프

• exec → 💻
• read → 📄
• write → ✍️
• edit → 📝
• attach → 📎
• 기본값 → 🛠️

​

시각적 매핑

• idle: 일반 동물.
• workingMain: 글리프가 있는 배지, 풀 틴트, 다리 “작업 중” 애니메이션.
• workingOther: 글리프가 있는 배지, 약한 틴트, 이동 없음.
• overridden: 활동에 상관없이 선택한 글리프/틴트 사용.

​

상태 행 텍스트 (메뉴)

• 작업이 활성화될 때: <세션 역할> · <활동 레이블>
  • 예시: 메인 · exec: pnpm test, 기타 · read: apps/macos/Sources/OpenClaw/AppState.swift.
• 유휴 상태일 때: 건강 요약본으로 돌아갑니다.

​

이벤트 수집

• 소스: 제어 채널 agent 이벤트 (ControlChannel.handleAgentEvent).
• 구문 분석된 필드:
  • stream: "job"은 시작/정지 상태에 대한 data.state와 함께.
  • stream: "tool"은 data.phase, name, 선택적 meta/args.
• 라벨:
  • exec: args.command의 첫 번째 줄.
  • read/write: 단축 경로.
  • edit: 경로와 meta/차이 수에서 추론된 변경 종류.
  • 기본값: 도구 이름.

​

디버그 오버라이드

• 설정 ▸ 디버그 ▸ “아이콘 오버라이드” 선택기:
  • 시스템 (자동) (기본값)
  • 작업 중: 메인 (도구 종류별)
  • 작업 중: 기타 (도구 종류별)
  • 유휴
• @AppStorage("iconOverride")를 통해 저장; IconState.overridden에 매핑됩니다.

​

테스트 체크리스트

• 메인 세션 작업 트리거: 아이콘이 즉시 전환되며 상태 행이 메인 레이블을 표시하는지 확인합니다.
• 메인 유휴 상태에서 비 메인 세션 작업 트리거: 아이콘/상태가 비 메인으로 표시되며, 작업이 끝날 때까지 안정적으로 유지됩니다.
• 다른 작업이 활성 상태일 때 메인 시작: 아이콘이 즉시 메인으로 전환됩니다.
• 빠른 도구 버스트: 배지가 깜박이지 않도록 확인 (도구 결과의 TTL 유예).
• 모든 세션이 유휴 상태가 되면 건강 상태 행이 다시 나타납니다.