Skip to content

State Machines

This page lists state machines that belong to the current core product surface. Deferred Workflow, World Evolution, delegated-provider, and hook scheduling models are intentionally not presented as Runtime prerequisites.

Runtime — Daemon Health

StateMeaning
STARTINGDaemon initializing
READYDaemon serving
DEGRADEDDaemon serving with reduced capability
STOPPINGDaemon draining; streams cancel cleanly

Runtime — ScenarioJob

StateTerminal?
SUBMITTEDno
RUNNINGno
COMPLETEDyes (success)
FAILEDyes
TIMEOUTyes
CANCELEDyes

Runtime — Provider Async Task

StateTerminal?
queuedno
runningno
succeededyes
failedyes
expiredyes (timeout-equivalent)

Provider async states use lower snake case; ScenarioJob uses upper snake case. The provider boundary maps terminal provider outcomes to the corresponding ScenarioJob result.

Realm — App-World Binding

StateMeaning
(new)World exists; no app bound
activeExtension app bound and writing
suspendedBinding paused
revokedBinding removed

This existing public-distribution model stays isolated from the current Windows product loop. It does not make an App or Desktop the owner of Realm truth.

Avatar — Composition State

StateMeaning
loadingInitial load
readyEmbodiment composed and rendering
degraded:*Degraded with a reason-specific sub-state
relaunch-pendingAwaiting relaunch

Source Basis

Documentation for Nimi — the installable, open-source, local-first personal AI product.