Concepts

Session lifecycle

creating → ready → attached / detached → running → closed

These are the states you will see as an operator or integrator.

• Detach must not kill a persistent session. The execution record keeps accumulating. You can walk away.
• Attach reconnects a client to a session it already owns. It does not transfer process ownership.
• Close / terminate ends the session and tears down processes JoyMux owns, according to the persistence mode you chose.

If a client vanishes, the session does not vanish with it.

Terminal session states are validated so conflicting lifecycle events cannot silently corrupt the recorded execution state. Once a session has ended, that terminal state does not move backward.

Related: checkpoints and resume, what JoyMux guarantees.