Barra de menús

# Qué se muestra

• Mostramos el estado de trabajo actual del agente en el icono de la barra de menús y en la primera fila de estado del menú.
• El estado de salud se oculta mientras hay trabajo activo; vuelve cuando todas las sesiones están inactivas.
• Un submenú raíz "Contexto" contiene las sesiones recientes en lugar de expandirlas directamente en el menú raíz.
• El bloque "Nodos" del menú raíz enumera solo dispositivos (nodos emparejados mediante node.list), no entradas de cliente/presencia.
• Una sección raíz "Uso" aparece debajo de Contexto cuando hay instantáneas de uso del proveedor disponibles, seguida de detalles de costo de uso cuando están disponibles.

# Modelo de estado

• Sesiones: los eventos llegan con runId (por ejecución) más sessionKey en la carga útil. La sesión "main" es la clave main; si no está presente, recurrimos a la sesión actualizada más recientemente.
• Prioridad: main siempre gana. Si main está activa, su estado se muestra de inmediato. Si main está inactiva, se muestra la sesión que no es main activa más recientemente. No alternamos a mitad de actividad; solo cambiamos cuando la sesión actual pasa a inactiva o main se activa.
• Tipos de actividad:
  • job: ejecución de comandos de alto nivel (state: started|streaming|done|error).
  • tool: phase: start|result con toolName y meta/args.

# Enum IconState (Swift)

• idle
• workingMain(ActivityKind)
• workingOther(ActivityKind)
• overridden(ActivityKind) (anulación de depuración)

# ActivityKind → glifo

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

# Mapeo visual

• idle: criatura normal.
• workingMain: insignia con glifo, tinte completo, animación de pata "trabajando".
• workingOther: insignia con glifo, tinte atenuado, sin correteo.
• overridden: usa el glifo/tinte elegido independientemente de la actividad.

# Submenú Contexto

• El menú raíz muestra una fila "Contexto" con un conteo/estado de sesiones y abre un submenú.
• El encabezado del submenú Contexto muestra el conteo de sesiones activas de las últimas 24 horas.
• Cada fila de sesión conserva su barra de tokens, antigüedad, vista previa, pensamiento/detalle, y acciones de restablecer, compactar y eliminar.
• Los mensajes de carga, desconexión y error de carga de sesión aparecen dentro del submenú Contexto.
• El uso del proveedor y los detalles de costo de uso permanecen en el nivel raíz debajo de Contexto para que sigan siendo visibles de un vistazo sin abrir el submenú.

# Texto de fila de estado (menú)

• Mientras hay trabajo activo: &lt;Session role&gt; · <activity label>
  • Ejemplos: Main · exec: pnpm test, Other · read: apps/macos/Sources/OpenClaw/AppState.swift.
• Cuando está inactivo: vuelve al resumen de salud.

# Ingesta de eventos

• Fuente: eventos agent del canal de control (ControlChannel.handleAgentEvent).
• Campos analizados:
  • stream: "job" con data.state para inicio/detención.
  • stream: "tool" con data.phase, name, meta/args opcionales.
• Etiquetas:
  • exec: primera línea de args.command.
  • read/write: ruta abreviada.
  • edit: ruta más tipo de cambio inferido a partir de meta/conteos de diff.
  • alternativa: nombre de la herramienta.

# Anulación de depuración

• Configuración ▸ Depuración ▸ selector "Anulación de icono":
  • System (auto) (predeterminado)
  • Working: main (por tipo de herramienta)
  • Working: other (por tipo de herramienta)
  • Idle
• Almacenado mediante @AppStorage("iconOverride"); mapeado a IconState.overridden.

# Lista de comprobación de pruebas

• Activar trabajo de sesión main: verificar que el icono cambie de inmediato y que la fila de estado muestre la etiqueta de main.
• Activar trabajo de sesión que no sea main mientras main está inactiva: el icono/estado muestra la sesión que no es main; permanece estable hasta que termine.
• Iniciar main mientras otra está activa: el icono cambia a main al instante.
• Ráfagas rápidas de herramientas: asegurar que la insignia no parpadee (gracia TTL en resultados de herramientas).
• La fila de salud reaparece una vez que todas las sesiones están inactivas.

# Relacionado

• app de macOS
• Icono de la barra de menús