Skip to content

cayu.sessions.InteractionTransitionSpec

Part of cayu.sessions.base. Read the Python API overview and install the required extra.

from cayu.sessions import InteractionTransitionSpec

Complete caller-owned identity of one interaction transition.

Bases: BaseModel.

Defaults below are source expressions; Field(...) includes schema/validation settings and default_factory creates a fresh value. Inherited declarations are included. Constructor behavior follows the model or dataclass shown in the bases/decorators.

Name Type Default
event Event required
from_statuses tuple[SessionStatus, ...] required
to_status SessionStatus required
only_if_no_queued_messages StrictBool False
model_completion_stage_settlement ModelCompletionStageSettlementRequest | None None
checkpoint_mutation dict[str, Any] | None None
terminal_event Event | None None
terminal_decision InvocationTerminalDecision | None None
InteractionTransitionSpec.copy_event(value: Event) -> Event
InteractionTransitionSpec.copy_terminal_event(value: Event | None) -> Event | None
InteractionTransitionSpec.copy_terminal_decision(value: InvocationTerminalDecision | None) -> InvocationTerminalDecision | None
InteractionTransitionSpec.canonicalize_source_statuses(value: tuple[SessionStatus, ...]) -> tuple[SessionStatus, ...]
InteractionTransitionSpec.copy_checkpoint_mutation(value: object) -> dict[str, Any] | None
InteractionTransitionSpec.validate_transition_shape() -> InteractionTransitionSpec

Release source · Runtime guarantees · Capability guides