Skip to content

cayu.sessions.SessionForkProfileRelationship

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

from cayu.sessions import SessionForkProfileRelationship

Immutable, content-bound profile authority for one session fork.

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
record_type Literal['cayu.session-fork-execution-profile'] FORK_EXECUTION_PROFILE_RECORD_TYPE
schema_version Literal[1, 2] required
request_sha256 str required
source_state_sha256 str | None None
source_session_id str required
child_session_id str required
child_agent_name str required
child_provider_name str required
child_model str required
child_environment_name str | None None
source_status SessionStatus required
source_run_epoch StrictInt Field(ge=0, le=MAX_DURABLE_JSON_INTEGER)
source_profile_source ForkExecutionProfileSource required
source_profile ExecutionProfileIdentity required
source_active_interaction_id str | None None
source_active_run_epoch StrictInt | None Field(default=None, ge=1, le=MAX_DURABLE_JSON_INTEGER)
transcript_cursor StrictInt | None Field(default=None, ge=0, le=MAX_DURABLE_JSON_INTEGER)
copy_checkpoint StrictBool required
system_prompt_policy ForkSystemPromptPolicy required
selection ForkExecutionProfileSelection required
selected_profile ExecutionProfileIdentity required
model_failover_candidate_index StrictInt | None Field(default=None, ge=0, le=7, exclude_if=lambda value: value is None)
source_environment_allocation_owners tuple[SessionForkEnvironmentAllocationOwner, ...] required
initial_invocation_request_sha256 str | None None
initial_dispatch_id str | None None
initial_invocation_profile ExecutionProfileIdentity | None None
decision ForkExecutionProfileDecisionRecord | None None
fork_event_id str required
SessionForkProfileRelationship.validate_identity_text(value: str, info) -> str
SessionForkProfileRelationship.validate_optional_identity_text(value: str | None, info) -> str | None

copy_environment_allocation_owners (method)

Section titled “copy_environment_allocation_owners (method)”
SessionForkProfileRelationship.copy_environment_allocation_owners(value: object) -> tuple[SessionForkEnvironmentAllocationOwner, ...]
SessionForkProfileRelationship.copy_profile(value: object) -> ExecutionProfileIdentity | None
SessionForkProfileRelationship.validate_relationship() -> SessionForkProfileRelationship

Release source · Runtime guarantees · Capability guides