LifecycleTransformerOptions

When true, the transformer emits the root lifecycle.started (or .running) event synchronously from onRegister and emits the terminal root event from finalize/fail. Set to false when an outer authority (e.g. RunProtocolSession) is responsible for root lifecycle emission; in that case the transformer still tracks root status internally for cascade purposes but does not write to the wire.

Resolves a human-readable graph name for a non-root namespace. The default uses the last segment of the namespace, stripping any :suffix (e.g. ["tools:abc"] -> "tools").

Optional async hook consulted by finalize() to override the computed terminal status. Returning a status here wins over the pending-interrupt heuristic. Useful for carriers (like the API session) that have authoritative knowledge of thread state.

Lifecycle status emitted for the root namespace when LifecycleTransformerOptions.emitRootOnRegister is true.

Human-readable name for the root graph. Used as graph_name for the root lifecycle event.

Converts an unknown failure value to a string for the lifecycle.failed error field.