cayu.sessions.SessionTopologyNode

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

from cayu.sessions import SessionTopologyNode

Bounded metadata-free identity for one session topology node.

Bases: BaseModel.

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
id	str	required
agent_name	str	required
provider_name	str	required
model	str	required
parent_session_id	str | None	required
causal_budget_id	str	required
runtime_name	str	required
runtime_version	str | None	required
runtime_build_provenance	RuntimeBuildProvenance	Field(default_factory=legacy_runtime_build_provenance)
environment_name	str | None	required
status	SessionStatus	required
created_at	datetime	required
updated_at	datetime	required
last_activity_at	datetime	required

from_session (method)

SessionTopologyNode.from_session(session: Session) -> SessionTopologyNode

validate_required_strings (method)

SessionTopologyNode.validate_required_strings(value: str, info) -> str

validate_bounded_ids (method)

SessionTopologyNode.validate_bounded_ids(value: str, info) -> str

validate_parent_session_id (method)

SessionTopologyNode.validate_parent_session_id(value: str | None) -> str | None

validate_optional_strings (method)

SessionTopologyNode.validate_optional_strings(value: str | None, info) -> str | None

normalize_timestamps (method)

SessionTopologyNode.normalize_timestamps(value: datetime, info) -> datetime

Release source · Runtime guarantees · Capability guides