Agent Squad — Lifecycle de una corrida (Intent → Trace)

Máquina de estados del executor durable: planning, ejecución de steps, human gate, reintentos y salidas terminales

01 / Fases del run 02 / Interrupciones + Loop de recuperación 03 / Salidas terminales 01 Queued intent → evento Inngest entry 02 Planning Nova compone el plan model 03 Executing executePlan · step.run work 04 Reviewing evaluator gate check 05 Completed trace succeeded · artifacts done Needs Approval human_gate · waitForEvent pause Blocked espera input/dependencia wait Failed STEP_HANDLER_ERROR · retryable retryable Cancelled detenido por el usuario terminal Expired gate timeout → artifact expired terminal Legend active state waiting terminal success failure / exit

Camino feliz

  • • Cinco fases ordenadas: queued → planning → executing → reviewing → completed
  • • El lifecycle vive en un solo riel horizontal (el Trace)
  • • Completed es una fase, no una caja suelta: trace 'succeeded' + artifacts publicados

Gates: humano + input

  • • Needs Approval pausa sin terminar el run (human_gate, waitForEvent durable)
  • • Blocked espera input o una dependencia faltante
  • • Los wait states reanudan de vuelta a planning/executing

Terminal + recuperación

  • • Failed reintenta mientras quede presupuesto (retry_policy en runWithRetry)
  • • Cancelled y Expired son salidas del lifecycle
  • • Las salidas terminales NO vuelven a ejecución activa

Lifecycle diagram • Built with Archify • Press T for theme and E for export