---
name: runner_status
lang: py
domain: core
version: "1.0.0"
algebraic: sum
definition: |
  class RunnerStatus(str, Enum):
      IDLE = "idle"
      STARTING = "starting"
      RUNNING = "running"
      PAUSED = "paused"
      STOPPING = "stopping"
      STOPPED = "stopped"
      COMPLETED = "completed"
      FAILED = "failed"
description: "Maquina de estados para un runner de simulacion o pipeline de larga duracion."
tags: [simulation, runner, status, state-machine, enum]
uses_types: []
file_path: "python/types/core/runner_status.py"
---

## Transiciones validas

```
IDLE -> STARTING -> RUNNING
RUNNING -> PAUSED -> RUNNING   (resume)
RUNNING -> STOPPING -> STOPPED
RUNNING -> COMPLETED
RUNNING -> FAILED
STARTING -> FAILED
```

## Notas

Tipo suma — exactamente uno de los estados es activo en cada momento. Hereda de `str` para que sea serializable a JSON directamente.
