Barra de Menú

Qué se muestra

• Mostramos el estado de trabajo actual del agente en el icono de la barra de menú y en la primera fila de estado del menú.
• El estado de salud se oculta mientras el trabajo está activo; regresa cuando todas las sesiones están inactivas.
• El bloque "Nodos" en el menú lista solo dispositivos (nodos emparejados vía node.list), no entradas de cliente/presencia.
• Una sección "Uso" aparece bajo Contexto cuando hay instantáneas de uso del proveedor disponibles.

Modelo de estado

• Sesiones: los eventos llegan con runId (por ejecución) más sessionKey en el payload. La sesión "principal" es la clave main; si está ausente, recurrimos a la sesión actualizada más recientemente.
• Prioridad: la principal siempre gana. Si la principal está activa, su estado se muestra inmediatamente. Si la principal está inactiva, se muestra la sesión no principal más recientemente activa. No cambiamos a mitad de una actividad; solo cambiamos cuando la sesión actual se vuelve inactiva o la principal se vuelve 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 "trabajando" en la pata.
• workingOther: insignia con glifo, tinte apagado, sin movimiento.
• overridden: usa el glifo/tinte elegido independientemente de la actividad.

Texto de la fila de estado (menú)

• Mientras el trabajo está activo: <Rol de sesión> · <etiqueta de actividad>
  • Ejemplos: Principal · exec: pnpm test, Otra · read: apps/macos/Sources/OpenClaw/AppState.swift.
• Cuando está inactivo: recurre 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, opcional meta/args.
• Etiquetas:
  • exec: primera línea de args.command.
  • read/write: ruta acortada.
  • edit: ruta más el tipo de cambio inferido de meta/recuentos de diferencias.
  • alternativa: nombre de la herramienta.

Anulación de depuración

• Configuración ▸ Depuración ▸ Selector "Anulación de icono":
  • Sistema (automático) (predeterminado)
  • Trabajando: principal (por tipo de herramienta)
  • Trabajando: otra (por tipo de herramienta)
  • Inactivo
• Almacenado vía @AppStorage("iconOverride"); mapeado a IconState.overridden.

Lista de verificación para pruebas

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

Configuración de Desarrollo para macOSActivación por Voz