AGENTS

Agent failure states

A diagnostic map for unavailable inputs and runtime conditions.

#State table

StateMeaningCan emit?
NO DATANo worker or no persisted inputsNo
CALIBRATING n / mIncomplete real windowNo
DATA DELAYEDSource outside valid ageNo
MARKET HALTEDUpstream halt flagNo
MODEL READYComplete valid input windowYes, on a new source snapshot
NO DECISION YETNo persisted outputNo existing entry

#Cycle errors

A failed market request records last_failed_cycle and last_error in heartbeat. It does not insert observations. A later success updates last_successful_cycle and clears the active error.

#Operator response

Check /status, engine logs, source timestamps, the heartbeat row, SQLite quick_check, and the configured environment before restarting services.