cayu.sessions.SessionInvocationAdmission

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

from cayu.sessions import SessionInvocationAdmission

One valid atomic admission of a profiled session invocation.

A clean resume starts a new interaction and compares execution_profile with session metadata. A continuation keeps the historical interaction and compares expected_active_invocation_profile with checkpoint authority. The store binds either profile to the newly claimed run epoch in the same transaction as status and interaction admission. Exactly one checkpoint callback is required; the store-time callback receives the receiving owner’s time inside that transaction for deadline validation.

Decorators: @dataclass(frozen=True).

Fields and attributes

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
from_statuses	frozenset[SessionStatus]	required
checkpoint_transform	CheckpointTransform | None	required
execution_profile	ExecutionProfileIdentity	required
interaction_source_messages	tuple[Message, ...]	required
tool_capability_ceiling	ToolCapabilityCeiling	required
result_checkpoint_transform	CheckpointTransform | None	None
interaction_started_event	Event | None	None
continued_interaction_id	str | None	None
defer_interaction_source	bool	False
model_transition	SessionModelTransition | None	None
execution_profile_decision	ExecutionProfileDecision | None	None
adopted_runtime_identity	SessionRuntimeIdentity | None	None
expected_active_invocation_profile	ActiveInvocationExecutionProfile | None	None
allow_pending_initial_interaction	bool	False
temporary_service_admission	TemporaryServiceAdmission | None	None
store_time_checkpoint_transform	StoreTimeCheckpointTransform | None	None

Release source · Runtime guarantees · Capability guides